更新默认组织权限
目的
要更新您组织的模块默认数据共享权限。
端点
- PUT /settings/data_sharing
请求详情
请求 URL
{api-domain}/crm/{version}/settings/data_sharing
支持的模块
潜在客户,Account,联系人,交易,活动,任务,案例,会议,电话,解决方案,产品,Vendors,价格手册,报价,SalesOrders,采购Orders,Invoices,预约,预约重排历史,服务和自定义模块。
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
ZohoCRM.settings.data_sharing.UPDATE
(或)
ZohoCRM.settings.data_sharing.ALL
示例请求
Copiedcurl "https://www.zohoapis.com/crm/v8/settings/data_sharing"
-X PUT
-d "@input.json"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"输入 JSON
- data_sharingJSON 数组,必填
包含您的组织对各模块默认数据共享权限的详细信息。
- share_type字符串,必填
表示在Zoho CRM中每个模块可用的访问级别。此键允许您根据需要修改Users的访问级别。
可能的取值:- private: 只有记录所有者及其上级可以查看该模块中的记录。
- public_read_only: Users可以查看其他人的记录,但无法修改或删除。
- public_read_write: Users可以查看和修改其他人的记录,但无法删除。
- public: Users可以查看、修改和删除其他人的记录。
- moduleJSON 对象
包含您希望在整个组织范围内更改用户访问权限的模块API名称与ID的详细信息。使用GET - 模块元数据 API 获取模块的API名称和ID。
注意
您可以修改系统定义模块和自定义模块的数据共享访问权限。
示例输入
Copied{
"data_sharing": [
{
"share_type": "public",
"module": {
"api_name": "Leads",
"id": "2276164000000000125"
}
}
]
}可能的错误
- INVALID_DATAHTTP 400
- 在 "module" 键中提供了无效的数据
解决方法:请在 "module" 键中指定有效的值。使用 GET - Modules Metadata API 获取模块的 API 名称和 ID。 - 在 "share_type" 键中提供了无效的数据
解决方法:请在 "share_type" 键中指定有效的值。
支持的值:private、public_read_only、public_read_write 和 public。详细信息请参阅 输入 JSON 部分。
- 在 "module" 键中提供了无效的数据
- MANDATORY_NOT_FOUNDHTTP 400
- INVALID_REQUEST_METHODHTTP 400
HTTP请求方法类型无效
解决办法:您为访问API URL 指定了无效的HTTP方法。
请指定有效的请求方法。请参阅端点部分。 - OAUTH_SCOPE_MISMATCHHTTP 401
未授权
解决方法:客户端没有有效的权限范围来更新组织的数据共享权限。请创建具有有效权限范围的新令牌。详情请参阅权限范围部分。 - AUTHENTICATION_FAILURE HTTP 401
Authentication失败
解决方法: 在API调用的请求头中传递访问令牌。 - INVALID_URL_PATTERNHTTP 404
请检查尝试访问的URL是否正确
解决方法:请求的URL不正确。请指定有效的请求URL。详情请参阅请求URL部分。请参阅上方的请求URL部分。 - INTERNAL_ERRORHTTP 500
内部服务器错误
解决方法:服务器中发生了意外且未处理的异常。请联系支持团队。
示例回复
Copied{
"data_sharing": [
{
"code": "SUCCESS",
"details": {
"module": "Leads"
},
"message": "data sharing settings updated successfully",
"status": "success"
}
]
}