更新变量
目的
要更新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”包含示例输入数据。
示例输入
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"
}
]
}