ID

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]
]);

擷取廣告時,同樣的結構也是一樣。