그룹 관리 API 메서드

그룹 만들기, 업데이트, 목록 작성, 삭제 등 그룹을 관리하는 나머지 API 메서드를 사용합니다.

그룹 만들기

새 사용자 그룹을 만드는 POST 메서드입니다.

요청

POST /api/v1/groups/

샘플 요청 본문

 {
    "name" : <string>,
    "description" : <string_may_be_null>,
 }

응답

  {
    "groupId" : <integer>,
    "pid" : <integer>,
    "name" : <string>,
    "description" : <string_may_be_null>,
    "membershipCount" : <integer>,
    "wildcards" : <list of strings>,
    "users" : <list of user IDs>
  }

그룹 업데이트

사용자 그룹을 업데이트하는 PUT 메서드입니다.

요청

PUT /api/v1/groups/<groupId>

샘플 요청 본문

 {
    "name" : <string>,
    "description" : <string_may_be_null>,
 }

응답

  {
    "groupId" : <integer>,
    "pid" : <integer>,
    "name" : <string>,
    "description" : <string_may_be_null>,
    "membershipCount" : <integer>,
    "wildcards" : <list of strings>,
    "users" : <list of user IDs>
  }

목록 그룹

사용자 그룹을 나열하는 GET 메서드입니다.

요청

GET /api/v1/groups/

응답

[
  {
    "groupId" : <integer>,
    "pid" : <integer>,
    "name" : <string>,
    "description" : <string_may_be_null>,
    "membershipCount" : <integer>,
    "wildcards" : <list of strings>,
    "users" : <list of user IDs>
  }, ...
]

그룹 삭제

사용자 그룹을 삭제하고 해당 그룹에서 모든 구성원을 제거하는 DELETE 메서드입니다.

요청

DELETE /api/v1/groups/<groupId>

성공하면 204 No Content 을 반환합니다. 충돌의 경우 409 Conflict을 반환합니다.

대량에서 그룹 삭제

여러 그룹을 일괄적으로 삭제하고 해당 그룹에서 모든 구성원을 제거하는 DELETE 메서드입니다.

요청

DELETE /api/v1/groups/bulk-delete

성공하면 204 No Content 을 반환합니다. 충돌의 경우 409 Conflict을 반환합니다.

그룹에 대한 모든 권한 나열

그룹에 있는 권한 개체를 나열하는 GET 메서드입니다.

요청

GET /api/v1/groups/{groupId}/permissions

응답

[{
 "objectId" : 34,
 "objectType": "SEGMENT",
 "permissions": ["READ", "WRITE", "DELETE", "MAP_TO_MODELS"]
 },

{
 "objectId" : "234",
 "objectType": "TRAIT",
 "permissions": ["READ", "WRITE", "DELETE", "MAP_TO_MODELS"]
 },
 {
 "objectId" : 277,
 "objectType": "SEGMENT",
 "permissions": ["READ", "WRITE", "MAP_TO_MODELS"]
 }
]

그룹에 액세스할 수 없는 경우 400 Bad Request 을 반환합니다.

그룹에 대한 권한 설정

그룹 권한을 업데이트하는 PUT 메서드입니다. 이 메서드는 이전 권한을 새 권한으로 덮어씁니다.

요청

PUT /api/v1/groups/{groupId}/permissions/

응답

[
  { "objectType" : "SEGMENT",
    "objectId" : 563,
    "permissions" : [ "READ", "WRITE"]
  },
  { "objectType" : "SEGMENT",
    "objectId" : 2363,
    "permissions" : [ "CREATE", "WRITE"]
  },
  { "objectType" : "TRAIT",
    "objectId" : 83498,
    "permissions" : [ "READ", "MAP_TO_SEGMENTS"]
  },
  { "objectType" : "DESTINATION",
    "objectId" : 304,
    "permissions" : [ "READ", "WRITE", "CREATE"]
  }
]

샘플 응답은 업데이트된 권한 객체 목록을 나타냅니다.

성공하면 200 OK 을 반환합니다. 주어진 권한이 잘못된 경우 400 을 반환합니다. 로그인한 사용자가 개체를 액세스할 수 없는 경우 403을 반환할 수도 있습니다.

이 페이지에서는