Zoho crm Logo

更新默认组织权限

目的

要更新您组织的模块默认数据共享权限。

端点

  • 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 部分。
  • MANDATORY_NOT_FOUNDHTTP 400

    缺少一个或多个必填项
    解决方法:请在输入内容中指定所有必填项。详见输入JSON部分。

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