Zoho crm Logo

激活自定义布局

目的

在您的Zoho CRM账户中激活先前已停用的自定义布局。

端点

  • POST /settings/layouts/{deactivated_layout_id}/actions/activate?module={module_api_name}

Request 详情

Request URL

{api-domain}/crm/{version}/settings/layouts/{layout_id}/actions/activate

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.settings.layouts.CREATE  (或者)
ZohoCRM.settings.layouts.ALL  (或者)
ZohoCRM.settings.ALL

参数

  • 模块字符串,必填

    指定您想要激活之前已停用的布局的模块API名称。使用GET模块元数据API来GET模块API名称。支持的模块有Leads,Contacts,Accounts,Deals,Products,Quotes,Sales Orders,Purchase,Orders,Invoices,Campaigns,Vendors,Price Books,Cases,Solutions和Custom。

样本请求

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/layouts/5725767000002483149/actions/activate?module=Leads"
-X POST
-d "@input.json"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf" 

这段代码无法翻译成中文,因为它是一段具有特定逻辑和结构的代码。在这种情况下,翻译可能会破坏其原有的逻辑和结构。

Request JSON

  • profilesJSON 数组,必填

    指定应有权访问布局的配置文件ID。至少指定一个配置文件以访问布局。您可以使用GET Profiles API检索配置文件ID。

样本输入

Copied{
    "layouts": [
        {
            "profiles": [
                {
                    "id": "5725767000000871001"
                },
                {
                    "id": "5725767000000091055"
                }
            ]
        }
    ]
}

可能的错误

  • ALREADY_ACTIVATEDHTTP 400
    无法激活已激活的布局 
    请指定一个有效且未激活的布局ID。使用GET布局元数据API来检索唯一的布局ID。来自布局元数据API的响应中的状态键表示布局是活动还是非活动。
  • NOT_ALLOWEDHTTP 400
    只有与模块关联的配置文件才能被分配给布局
    解决方案:将有效的配置文件分配给布局。
  • MANDATORY_NOT_FOUNDHTTP 400
    缺少必填字段
    解决方案:至少分配一个配置文件以激活布局。使用GET配置文件API来检索配置文件的ID。

样本回应

Copied{
    "layouts": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "5725767000002483149"
            },
            "message": "布局已激活",
            "status": "成功"
        }
    ]
}