大多数 Google Ads 实体都公开了用于返回其标识符的 getId()
方法。虽然在大多数情况下,ID 并非绝对必要,但在以下情况下,ID 可能会派上用场:
- 使用报告
- ID 是将报告行与实际 Google Ads 实体相关联的好方法。
- 维护与外部数据存储之间的映射
- 您可能已经在自己的数据库中存储了基于 ID 的信息。
- 寻求性能方面的提升
通过 ID 来抓取通常要比其他方法更快。用于提取单个实体的代码也更简单一些:
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // vs. let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
唯一性
广告系列 ID 和广告组 ID 是唯一的:两个广告系列或广告组绝不会共用同一个 ID。不过,广告和关键字具有复合 ID:关键字的唯一标识符是其广告组 ID 和关键字 ID 的组合。同样,广告的唯一标识符是其广告组 ID 和广告 ID 的组合。这对 selector.withIds()
的调用方式有影响。
对于广告系列和广告组,selector.withIds()
期望使用数组:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
不过,对于广告和关键字,selector.withIds()
需要一个包含两个元素数组的数组,第一个元素是广告组 ID。以下代码段会从广告组中检索三个关键字:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
提取广告时,也适用相同的构造。