大多數 Google Ads 實體都會公開 getId()
方法,用於傳回其 ID。雖然在大多數情況下並非必要,但在以下情況下,ID 可能會派上用場:
- 使用報表
- ID 很適合用來將報表列連結至實際的 Google Ads 實體。
- 維護與外部資料儲存的對應
- 您可能已將 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 是廣告群組 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]
]);
擷取廣告時也適用相同的結構。