更新服务偏好设置
目的
要更新您组织中的服务偏好设置。
端点
- PUT /settings/service_preferences
请求详情
请求 URL
{api-domain}/crm/{version}/settings/service_preferences
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
scope=ZohoCRM.设置.模块.{operation_type}
可能的操作类型
全部 - 完全访问服务偏好数据
Update - Update 服务偏好
示例请求
Copiedcurl "https://www.zohoapis.com/crm/v8/settings/service_preferences"
-X PUT
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"请求 JSON 键
- job_sheet_enabled布尔值,必填
表示是否为您的组织启用作业单。
可能的取值:
true - 启用作业单。这是默认值。
false - 禁用作业单。
示例输入
Copied{
"service_preferences": {
"job_sheet_enabled": false
}
}可能的错误
- API_NOT_SUPPORTEDHTTP 400
该 API 在此版本中不受支持。
解决方案: 该 API 仅在版本 3 及以上支持。 - INVALID_DATAHTTP 400
您为 job_sheet_enabled 键指定了无效的值。
解决方案:job_sheet_enabled 键的数据类型为布尔值,唯一可能的取值为 true 和 false。 - INVALID_REQUEST_METHODHTTP 400
您使用了无效的 HTTP 请求方法类型。
解决方案: 在请求中仅使用 PUT 方法来访问此 API。 - INVALID_TOKENHTTP 401
您使用了无效的 oauth 令牌。
解决方案:您使用的访问令牌已过期。请刷新您的令牌并重试。 - OAUTH_SCOPE_MISMATCHHTTP 401
您使用了错误的 OAuth 作用域创建了授权令牌。
解决方法:请使用 ZohoCRM.settings.modules.UPDATE 或 ZohoCRM.settings.modules.ALL 作用域来创建一个新的有效授权令牌。 - NO_PERMISSIONHTTP 403
您没有权限更新服务偏好设置。
解决方案:请联系您的系统管理员。 - INTERNAL_ERRORHTTP 500
服务器内部错误
解决方案:服务器发生了意外且未处理的异常。请联系我们的支持团队。
示例响应
Copied{
"service_preferences": {
"code": "SUCCESS",
"details": {},
"message": "Services preferences updated successfully",
"status": "success"
}
}