Zoho crm Logo

更新服务偏好设置

目的

要更新您组织中的服务偏好设置。

端点

  • 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"
    }
}