更新多个标签

目的

同时更新多个标签。

请求URL

https://www.zohoapis.com.cn/crm/v2/settings/tags?module={module_api_name}

module_api_name - 模块的API名称

请求方法

PUT

范围

scope=ZohoCRM.settings.all
(或)
scope=ZohoCRM.settings.tags.{operation_type}

可能的操作类型
ALL - 完全数据访问 WRITE - 编辑标签数据 UPDATE - 更新标签数据

参数

参数名称	数据类型	描述
module (必填)	字符串	指定模块的API名称，如lead、Contacts、Accounts、Deals等。

Curl PHP Csharp

示例请求

在这个输入中，@multipletagupdate.json包含了示例输入数据


				curl "https://www.zohoapis.com.cn/crm/v2/settings/tags?module=Contacts"
-X PUT
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@multipletagupdate.json"

示例输入


				{
    "tags": [
       {
            "id": "410888000000482039",
            "name": "Chems"
        },
       {
            "id": "410888000000482040",
            "name": "Agricultural"
        }
    ]
}

示例响应


				{
    "tags": [
       {
            "code": "SUCCESS",
            "message": "tags updated successfully",
            "status": "success",
            "details": {
                "created_by": {
                    "id": "2000000030444",
                    "name": "Chems"
                },
                "created_time": "2017-03-24T11:08:23+05:30",
                "id": "2000000088041",
                "modified_by": {
                    "id": "2000000030784",
                    "name": "Medical"
                },
                "modified_time": "2017-03-24T11:08:23+05:30"
            }
        },
       {
            "code": "SUCCESS",
            "message": "tags updated successfully",
            "status": "success",
            "details": {
                "created_by": {
                    "id": "2000000030344",
                    "name": "Agricultural"
                },
                "created_time": "2017-03-24T11:08:23+05:30",
                "id": "2000000088041",
                "modified_by": {
                    "id": "2000000038764",
                    "name": "Rural"
                },
                "modified_time": "2017-03-24T11:08:23+05:30"
            }
        }
    ]
}

示例请求


				/** 多个标签更新 */
$zcrmModuleIns=ZCRMModule::getInstance("Leads");
$tagsArray= array();
$tag = ZCRMTag::getInstance("3372164000001597013");
$tag->setName("Name3");
array_push($tagsArray, $tag);
$tag = ZCRMTag::getInstance("3372164000001585002");
$tag->setName("Name4");
array_push($tagsArray, $tag);
$bulkAPIResponse = $zcrmModuleIns->updateTags($tagsArray); //$tagsArray - ZCRMTag实例的数组
$tags = $bulkAPIResponse->getData(); //$tags - ZCRMTag实例的数组

示例输入


				{
    "tags": [
       {
            "id": "410888000000482039",
            "name": "Chems"
        },
       {
            "id": "410888000000482040",
            "name": "Agricultural"
        }
    ]
}

示例响应


				{
    "tags": [
       {
            "code": "SUCCESS",
            "message": "tags updated successfully",
            "status": "success",
            "details": {
                "created_by": {
                    "id": "2000000030444",
                    "name": "Chems"
                },
                "created_time": "2017-03-24T11:08:23+05:30",
                "id": "2000000088041",
                "modified_by": {
                    "id": "2000000030784",
                    "name": "Medical"
                },
                "modified_time": "2017-03-24T11:08:23+05:30"
            }
        },
       {
            "code": "SUCCESS",
            "message": "tags updated successfully",
            "status": "success",
            "details": {
                "created_by": {
                    "id": "2000000030344",
                    "name": "Agricultural"
                },
                "created_time": "2017-03-24T11:08:23+05:30",
                "id": "2000000088041",
                "modified_by": {
                    "id": "2000000038764",
                    "name": "Rural"
                },
                "modified_time": "2017-03-24T11:08:23+05:30"
            }
        }
    ]
}

示例请求


				ZCRMModule modulesIns = ZCRMModule.GetInstance("Leads");
List<ZCRMTag> tags = new List<ZCRMTag>();
ZCRMTag tag1 = ZCRMTag.GetInstance(3372164000001536001);
tag1.Name = "Name3";
ZCRMTag tag2 = ZCRMTag.GetInstance(3372164000001536002);
tag2.Name = "Name4";
tags.Add(tag1);
tags.Add(tag2);
BulkAPIResponse<ZCRMTag> response = modulesIns.UpdateTags(tags); //tags - 包含更新所需数据的ZCRMTag实例列表。
List<ZCRMTag> updatedtags = response.BulkData; //tags - ZCRMTag实例列表
List<EntityResponse> entityResponses = response.BulkEntitiesResponse; //entityResponses - EntityResponse实例的列表

示例输入


				{
    "tags": [
       {
            "id": "410888000000482039",
            "name": "Chems"
        },
       {
            "id": "410888000000482040",
            "name": "Agricultural"
        }
    ]
}

示例响应


				{
    "tags": [
       {
            "code": "SUCCESS",
            "message": "tags updated successfully",
            "status": "success",
            "details": {
                "created_by": {
                    "id": "2000000030444",
                    "name": "Chems"
                },
                "created_time": "2017-03-24T11:08:23+05:30",
                "id": "2000000088041",
                "modified_by": {
                    "id": "2000000030784",
                    "name": "Medical"
                },
                "modified_time": "2017-03-24T11:08:23+05:30"
            }
        },
       {
            "code": "SUCCESS",
            "message": "tags updated successfully",
            "status": "success",
            "details": {
                "created_by": {
                    "id": "2000000030344",
                    "name": "Agricultural"
                },
                "created_time": "2017-03-24T11:08:23+05:30",
                "id": "2000000088041",
                "modified_by": {
                    "id": "2000000038764",
                    "name": "Rural"
                },
                "modified_time": "2017-03-24T11:08:23+05:30"
            }
        }
    ]
}