그룹 관리 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을(를) 반환할 수도 있습니다.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now