接口文档SDK业务专题开发者工具

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: 字符串;