Zoho crm Logo

更新变量

目的

要更新CRM中变量的详细信息。

端点

  • PUT /settings/variables
  • PUT /settings/variables/{variable_id (or) variable_api_name}

请求详情

请求 URL

{api-domain}/crm/{version}/settings/variables

要更新指定的变量:
{api-domain}/crm/{version}/settings/variables/{variable_id (或) variable_api_name}

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.设置.变量.{operation_type}

可能的操作类型

全部 - 完全访问变量数据
Update - Update变量数据

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/variables/40000000047010"
(or)
curl "https://www.zohoapis.com/crm/v8/settings/variables/Variable444"
-X PUT
-d @updatevariables.json
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
Copiedvariable1 = Map();
variable1.put("id", "692969000000981112");
variable1.put("value", "9");

variable2 = Map();
variable2.put("id", "692969000000983066");
variable2.put("description", "This is a new description");

variable3 = Map();
variable3.put("id", "692969000000981114");
variable3.put("api_name", "NewAPI");

variables_list = List();
variables_list.add(variable1);
variables_list.add(variable2);
variables_list.add(variable3);

param = Map();
param.put("variables", variables_list);
	response = invokeurl
[
	url: "https://www.zohoapis.com/crm/v8/settings/variables"
	type: PUT
	parameters: param.toString()
	connection:"crm_oauth_connection"
];
info response;

在请求中,“@updatevariables.json”包含示例输入数据。

输入 JSON 

  • id字符串,必填

    请指定您想要更新的变量的唯一ID。参考 获取变量 API 以获取变量的唯一ID。

有关其他输入参数,请参考 创建变量 API。 您不能更新变量的类型或变量组。

示例输入

Copied{
    "variables": [
       {
            "id": "40000000047003",
            "value": "This is a new value"
        },
       {
            "id": "40000000047007",
            "description": "This is a new description"
        },
       {
            "id": "40000000047009",
            "api_name": "NewAPI"
        }
    ]
}

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

    HTTP请求方法类型无效
    解决方法:您为访问API URL 指定了无效的HTTP方法。请指定有效的请求方法。请参阅上方的端点部分。

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限来更新变量
    解决方法:该用户没有更新变量的权限。请联系您的系统管理员。

  • INVALID_DATAHTTP 400

    数据无效
    解决方法:指定的变量ID不正确。请参考 获取变量 API 以获取唯一的变量ID。

  • DUPLICATE_DATAHTTP 400

    重复数据
    解决方法:您为一个或多个唯一字段指定了重复的值。请参阅 字段元数据 API 以了解唯一字段。

  • MANDATORY_NOT_FOUNDHTTP 400

    未找到必填字段
    解决方法:您在输入中未指定一个或多个必填字段。请参考字段元数据 API以了解必填字段。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方法:客户端没有ZohoCRM.settings.variables.UPDATE权限。请创建具有有效权限的新客户端。请参考上方的权限(scope)部分。

  • NO_PERMISSIONHTTP 403

    没有权限更新记录
    解决方法:用户没有更新变量的权限。请联系系统管理员。

  • INVALID_URL_PATTERN HTTP 404

    请检查您尝试访问的URL是否正确
    解决方法:请求的URL填写不正确,请指定一个有效的请求URL。请参阅上方的请求URL部分。

  • INTERNAL_ERRORHTTP 500

    服务器内部错误
    解决方案:服务器出现了意外且未处理的异常。请联系支持团队。

示例回应

Copied{
    "variables": [
       {
            "code": "SUCCESS",
            "details": {
                "id": "40000000047003"
            },
            "message": "variable updated",
            "status": "success"
        },
       {
            "code": "SUCCESS",
            "details": {
                "id": "40000000047007"
            },
            "message": "variable updated",
            "status": "success"
        },
       {
            "code": "SUCCESS",
            "details": {
                "id": "40000000047009"
            },
            "message": "variable updated",
            "status": "success"
        }
    ]
}