filtering结构
- 当且仅当接口文档中有filtering参数时,接口才支持过滤逻辑;
- 过滤条件中,支持包含同一字段多个不同运算并存,不支持同一字段多个相同运算符并存,当出现此条件时的处理为后一参数覆盖前一参数;
- 多个条件结构间的运算逻辑为”and”;
- 每个结构包含3个必填节点:field(字段名)、operator (操作符)、values(取值);
- values(取值)的数组长度与operator的取值有关,其对应关系如下:
- 当 operator 为 EQUALS、CONTAINS、LESS_EQUALS、LESS、GREATER_EQUALS、GREATER 时,values数组长度为1;
- 当 operator 为 IN 时,values数组长度为100;
示例:
filtering=[{"field":"system_status", "operator": "EQUALS", "values":["AD_STATUS_PENDING"]}, {"field":"adgroup_name", "operator": "CONTAINS", "values": ["广告"]}]
action_param结构
action_param是一个Map,key 类型为 string,value 的类型支持以下几种:
- int 或 int[] : 64位整数;
- float 或 float[]: 最大值100000000000 (一千亿),保留3位小数精度,超过的截断,而非四舍五入;
- boolean 或 boolean[]: 支持字面值为:true,false;
- string 或 string[]: 字符串;
其类型约束在服务端控制,如果不满足约束,将返回对应的错误。
property_param_map结构
property_param_map是一个Map,key 类型为 string,value 的类型支持以下几种:
- float: 最大值100000000000;
- boolean: 支持字面值为:true,false;
- string: 字符串;