群組管理 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。

本頁內容