管理权限组
管理权限组定义哪些代理可以创建、更新、归档和发布文章。它由一组特权组成,每个特权都映射到用户组.代理接收与其所属用户段相关联的任何权限。
权限组可以定义的特权类型取决于您的向导计划:
- 指南企业支持
编辑
和发布
特权 - 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 - u{email_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 - u{email_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 - u{email_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 - u{email_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 - u{email_address}:{密码}- x删除
示例响应
状态:204无内容