向多个记录添加标记

目的

同时向多个记录添加标记。

请求URL

https://www.zohoapis.com.cn/crm/v2/{module_api_name}/actions/add_tags?ids={entity_id1}&tag_names={tag1},{tag2}

请求方法

POST

范围

scope=ZohoCRM.modules.all
(或)
scope=ZohoCRM.modules.{module_name}.{operation_type}

 
可能的模块名称可能的操作类型
线索，客户，联系人，商机，市场活动，任务，服务支持，事件，通话，解决方案，产品，供货商，价格表，报价单，销售订单，采购订单，发货单和自定义模块ALL - 完全数据访问
WRITE - 编辑标记数据
CREATE - 创建标记数据

参数

参数名称数据类型描述
tag_names字符串指定要添加的标记名称。
over_write布尔型指定是否要覆盖现有标记。默认值是false。
ids
(必填)		整型指定记录的唯一ID
CurlPHPCsharp

示例请求


				curl "https://www.zohoapis.com.cn/crm/v2/Contacts/actions/add_tags?ids=1234567890,123456789&tag_names=From Email,High Priority&over_write=true"
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

示例响应


				{
    "data": [
       {
            "code": "FAILURE",
            "details": {
                "id": "2445013000000402006"
            },
            "message": "tags not updated successfully",
            "status": "error"
        },
       {
            "code": "SUCCESS",
            "details": {
                "id": "2445013000000141005",
                "tags": [
                    "From Email",
                    "High Priority"
                ]
            },
            "message": "tags updated successfully",
            "status": "success"
        }
    ],
    "wf_scheduler": "false",
    "success_count": "1"
}

示例请求


				/** 向多个记录添加标记 */
$zcrmModuleIns = ZCRMModule::getInstance("Leads");
$tagNames = array("Name7","Name8");
$recordids = array("3372164000001494008","3372164000001295433");
$bulkAPIResponse = $zcrmModuleIns->addTagsToRecords($recordids, $tagNames); //$recordids 记录ID数组， $tagName 标记名称数组
$records = $bulkAPIResponse->getData(); //$records - ZCRMRecord 实例数组

示例响应


				{
    "data": [
       {
            "code": "FAILURE",
            "details": {
                "id": "2445013000000402006"
            },
            "message": "tags not updated successfully",
            "status": "error"
        },
       {
            "code": "SUCCESS",
            "details": {
                "id": "2445013000000141005",
                "tags": [
                    "From Email",
                    "High Priority"
                ]
            },
            "message": "tags updated successfully",
            "status": "success"
        }
    ],
    "wf_scheduler": "false",
    "success_count": "1"
}

示例请求


				ZCRMModule moduleIns = ZCRMModule.GetInstance("Leads"); // 模块API名称
List<string> tagNames = new List<string>{ "Name7", "Name8" };
List<long> recordIds = new List<long>{3372164000001494008,3372164000001295433};
BulkAPIResponse<ZCRMRecord> response = moduleIns.AddTagsToRecords(recordIds, tagNames); //recordIds 记录ID列表，tagNames 标记名称列表
List<ZCRMRecord> records = response.BulkData; //records - ZCRMRecord 实例列表
List<EntityResponse> entityResponses = response.BulkEntitiesResponse; // entityResponses - EntityResponse 实例列表

示例响应


				{
    "data": [
       {
            "code": "FAILURE",
            "details": {
                "id": "2445013000000402006"
            },
            "message": "tags not updated successfully",
            "status": "error"
        },
       {
            "code": "SUCCESS",
            "details": {
                "id": "2445013000000141005",
                "tags": [
                    "From Email",
                    "High Priority"
                ]
            },
            "message": "tags updated successfully",
            "status": "success"
        }
    ],
    "wf_scheduler": "false",
    "success_count": "1"
}
       Sign up for free Access Zoho crm