TargetingTemplates

有关此类资源的方法列表，请参阅本页面的结尾部分。

资源表示形式

包含某个定位模板的属性。定位模板涵盖可在多个广告中重复使用的定位信息。

{
  "kind": "dfareporting#targetingTemplate",
  "id": long,
  "accountId": long,
  "subaccountId": long,
  "advertiserId": long,
  "advertiserIdDimensionValue": dimensionValues Resource,
  "name": string,
  "geoTargeting": {
    "excludeCountries": boolean,
    "countries": [
      countries Resource
    ],
    "regions": [
      regions Resource
    ],
    "cities": [
      cities Resource
    ],
    "metros": [
      metros Resource
    ],
    "postalCodes": [
      postalCodes Resource
    ]
  },
  "technologyTargeting": {
    "operatingSystems": [
      operatingSystems Resource
    ],
    "browsers": [
      browsers Resource
    ],
    "platformTypes": [
      platformTypes Resource
    ],
    "mobileCarriers": [
      mobileCarriers Resource
    ],
    "connectionTypes": [
      connectionTypes Resource
    ],
    "operatingSystemVersions": [
      operatingSystemVersions Resource
    ]
  },
  "dayPartTargeting": {
    "userLocalTime": boolean,
    "daysOfWeek": [
      string
    ],
    "hoursOfDay": [
      integer
    ]
  },
  "keyValueTargetingExpression": {
    "expression": string
  },
  "languageTargeting": {
    "languages": [
      languages Resource
    ]
  },
  "listTargetingExpression": {
    "expression": string
  }
}

属性名称	值	说明	备注
accountId	long	此定位模板的帐号 ID。如果未设置，系统会在插入时自动生成该字段；在插入后，该字段是只读字段。
advertiserId	long	此定位模板的广告客户 ID。在插入时，该字段是必填字段；在插入后，会变成只读字段。
advertiserIdDimensionValue	nested object	广告客户的 ID 的维度值。该字段是自动生成的只读字段。
dayPartTargeting	nested object	时间和日期定位条件。
dayPartTargeting.daysOfWeek[]	list	广告将在一周中的哪几天投放。 可接受的值包括： “SUNDAY” “MONDAY” “TUESDAY” “WEDNESDAY” “THURSDAY” “FRIDAY” “SATURDAY”
dayPartTargeting.hoursOfDay[]	list	广告将在一天中的哪些时段投放，其中 0 表示午夜零点至凌晨 1 点，23 表示晚上 11 点至午夜零点。该字段可搭配星期几一同指定。在这种情况下，广告会在指定日期的这些时段投放。例如，如果在一周中指定了星期一、星期三、星期五这几天，同时指定了上午 9 点至 10 点和下午 3 点至 5 点（即时段 9、15 和 16），广告就会在星期一、星期三和星期五的上午 9 点至 10 点和下午 3 点至 5 点投放。可接受的值介于 0（含）到 23（含）之间。
dayPartTargeting.userLocalTime	boolean	是否使用用户的当地时间。如果此字段设为 false，则适用美国/纽约时区。
geoTargeting	nested object	地理位置定位条件。
geoTargeting.cities[]	list	要定位到的城市。对于各个城市，只有 dartId 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位的是某个城市，请不要定位或排除该城市所在的国家/地区，也不要定位该城市所在的都市圈或区域。
geoTargeting.countries[]	list	要在定位条件中定位或排除的国家/地区，具体取决于 excludeCountries 字段的设置。对于各个国家/地区，只有 dartId 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位或排除的是某个国家/地区，请不要定位该国家/地区内的区域、城市、都市圈或邮政编码。
geoTargeting.excludeCountries	boolean	是否从定位条件中排除 countries 字段中的国家/地区。如果此字段设为 false，countries 字段则会引用广告将要定位的国家/地区。
geoTargeting.metros[]	list	要定位到的都市圈。对于各个都市圈，只有 dmaId 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位的是某个都市圈，请不要定位或排除该都市圈所在的国家/地区。
geoTargeting.postalCodes[]	list	要定位到的邮政编码。对于各个邮政编码，只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位的是某个邮政编码，请不要定位或排除该邮政编码所属的国家/地区。
geoTargeting.regions[]	list	要定位到的区域。对于各个区域，只有 dartId 是必填字段。其他字段会在广告插入或更新时自动填充。如果定位的是某个区域，请不要定位或排除该区域所在的国家/地区。
id	long	此定位模板的 ID。该字段是自动生成的只读字段。
keyValueTargetingExpression	nested object	键值对定位条件。
keyValueTargetingExpression.expression	string	广告当前定位到的关键字表达式。
kind	string	标识所属资源种类。值：固定字符串 "dfareporting#targetingTemplate"。
languageTargeting	nested object	语言定位条件。
languageTargeting.languages[]	list	此广告定位到的语言。对于各种语言，只有 languageId 是必填字段。其他字段会在广告插入或更新时自动填充。
listTargetingExpression	nested object	再营销列表定位条件。
listTargetingExpression.expression	string	说明广告当前定位到的列表的表达式。
name	string	此定位模板的名称。该字段为必填字段。该值的长度必须少于 256 个字符，且在同一个广告客户中是唯一的。
subaccountId	long	此定位模板的子帐号 ID。如果未设置，系统会在插入时自动生成该字段；在插入后，该字段是只读字段。
technologyTargeting	nested object	技术平台定位条件。
technologyTargeting.browsers[]	list	此广告定位到的浏览器。对于各个浏览器，请设置 browserVersionId 或 dartId 以及版本号。如果这两者都被指定了，系统只会使用 browserVersionId。其他字段会在广告插入或更新时自动填充。
technologyTargeting.connectionTypes[]	list	此广告定位到的连接类型。对于各个连接类型，只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。
technologyTargeting.mobileCarriers[]	list	此广告定位到的移动运营商。对于各个移动运营商，只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。如果已定位到移动运营商，请不要同时定位到邮政编码。
technologyTargeting.operatingSystemVersions[]	list	此广告定位到的操作系统版本。如需定位到所有版本，请使用 operatingSystems。对于各个操作系统版本，只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。如果已定位到操作系统版本，请不要同时在 operatingSystems 中定位到相应的操作系统。
technologyTargeting.operatingSystems[]	list	此广告定位到的操作系统。如需定位特定版本，请使用 operatingSystemVersions。对于各个操作系统，只有 dartId 是必填字段。其他字段会在广告插入或更新时自动填充。如果已定位到操作系统，请不要同时使用操作系统版本定位到同一操作系统。
technologyTargeting.platformTypes[]	list	此广告定位到的平台类型。例如，桌面设备、移动设备或平板电脑。对于各个平台类型，只有 id 是必填字段。其他字段会在广告插入或更新时自动填充。

方法

get

根据 ID 获取一个定位模板。

insert

插入新的定位模板。

list

检索定位模板列表，该列表可能经过了过滤。此方法支持分页。

patch

更新现有定位模板。此方法支持补丁语义。

update

更新现有定位模板。