管理权限组定义哪些代理可以创建、更新、归档和发布文章。它由一组特权组成,每个特权都映射到用户组.代理接收与其所属用户段相关联的任何权限。

权限组可以定义的特权类型取决于您的向导计划:

  • 指南企业支持编辑发布特权
  • Guide Professional支持发布特权
  • Guide Lite不允许创建或更新权限组。然而,发布切换到Lite时,仍然会对存在的任何权限组授予特权

权限组是在帐户级别定义的,而不是品牌级别。如果您使用品牌作为请求的子域,API会将请求重定向到该帐户的主子域。

您可以使用此API定义或更改权限组。但是,您必须使用文章API将管理权限组应用到文章。可以修改用户段的定义用户段API。

JSON格式

管理权限组具有以下属性:

名字 类型 只读 强制性的 评论
id 整数 是的 没有 创建权限组时自动分配
名字 字符串 没有 没有 权限组名称
编辑 数组 没有 没有 具有编辑权限的用户段id
发布 数组 没有 没有 具有发布权限的用户段id
created_at 时间戳 是的 没有 创建权限组时
updated_at 时间戳 是的 没有 上一次更新权限组的时间
built_in 布尔 是的 没有 权限组是否内置。不支持修改内置权限组

例子

             
“permission_group”“id”42“名称”“打印机专家”“built_in”“发布”123456]“编辑”]“created_at”“2018-08-23 12:42:18 +0000”“updated_at”“2018-08-23 12:42:18 +0000”}}

权限组列表

得到/ api / v2 /指导/ permission_groups.json

允许

  • 帮助中心经理

使用旋度

             
旋度https://子域名}.亚博zendesk.com/api/v2/guide/permission_groups.json- v - uemail_address}密码}

示例响应

             
状态:200 OK“permission_groups”:(“id”:42岁“姓名”:“打印机专家”;“built_in”:假的,“发布”:[123456],“编辑”:[],"created_at": "2018-08-23 12:42:18 +0000","updated_at": "2018-08-23 12:42:18 +0000"},“id”:75年,“名称”:“经理”,“built_in”:没错,“发布”:[],“编辑”:[],"created_at": "2018-03-16 08:29:27 +0000","updated_at": "2018-03-16 08:29:27 +0000"},]}

显示权限组

GET / api / v2 /指导/ permission_groups / {id} . json

允许

  • 帮助中心经理

使用旋度

             
旋度https://子域名}.亚博zendesk.com/api/v2/guide/permission_groups/id}. json- v - uemail_address}密码}

示例响应

             
状态:200 OK" permission_group ": {“id”:42岁“姓名”:“打印机专家”;“built_in”:假的,“发布”:[12],“编辑”:[34],"created_at": "2018-08-23 12:42:18 +0000","updated_at": "2018-08-23 12:42:18 +0000"}}

创建权限组

POST / api / v2 /指导/ permission_groups.json

允许

  • 帮助中心经理

使用旋度

             
旋度https://子域名}.亚博zendesk.com/api/v2/guide/permission_groups.json- d' {\"permission_group": {\"name": "Printer Experts", \“编辑”:[12,…],\“发布”:[34,…]) \} \} '- v - uemail_address}密码}-x post -h“application / json内容类型:

示例响应

             
状态:201已创建" permission_group ": {“id”:42岁“姓名”:“打印机专家”;“built_in”:假的,"publish":[34,…],“编辑”:[12,…],"created_at": "2018-08-23 12:42:18 +0000","updated_at": "2018-08-23 12:42:18 +0000"}}

更新权限组

把/ api / v2 /指导/ permission_groups / {id} . json

允许

  • 帮助中心经理

使用旋度

             
旋度https://子域名}.亚博zendesk.com/api/v2/guide/permission_groups/id}. json- d' {\"user_segment": {\"name": "Super Printer Experts", \“编辑”:[],\"publish":[42,…],\} \} '- v - uemail_address}密码}-x放-h“application / json内容类型:

示例响应

             
状态:200 OK" permission_group ": {“id”:42岁“姓名”:“超级打印机专家”;“built_in”:假的,"publish":[42,…],“编辑”:[],"created_at": "2018-08-23 12:42:18 +0000","updated_at": "2018-08-24 00:42:15 +0000"}}

删除权限组

删除/ api / v2 /指导/ permission_groups / {id} . json

允许

  • 帮助中心经理

使用旋度

             
旋度https://子域名}.亚博zendesk.com/api/v2/guide/permission_groups/id}. json- v - uemail_address}密码}- x删除

示例响应

             
状态:204无内容