ID

ほとんどの Google 広告エンティティは、ID を返す getId() メソッドを公開しています。ほとんどの場合、厳密に必要なわけではありませんが、次のような場合に身分証明書が役立ちます。

レポートの操作
ID を使用すると、レポートの行を実際の Google 広告エンティティにリンクできます。
外部データ ストアとのマッピングを維持する場合
ID ベースの情報がすでに独自のデータベースに保存されている場合があります。
パフォーマンスの向上を求める場合

通常、ID によるデータの取得は他の方法よりも高速です。単一のエンティティを取得するコードも少し簡単になります。

let campaigns = AdsApp.campaigns()
   .withIds([678678])
   .get();
// vs.
let campaigns = AdsApp.campaigns()
   .withCondition("Name='My Campaign'")
   .get();

一意性

キャンペーン ID と広告グループ ID は一意です。2 つのキャンペーンまたは広告グループが同じ ID を共有することはありません。ただし、広告とキーワードには複合 ID があります。キーワードの一意の識別子は、広告グループ ID とキーワード ID の組み合わせです。同様に、広告の一意の識別子は、広告グループ ID と広告 ID の組み合わせです。これは、selector.withIds() の呼び出し方法に影響します。

キャンペーンと広告グループの場合、selector.withIds() には数値の配列を指定します。

let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);

ただし、広告とキーワードの場合は、selector.withIds() に 2 要素の配列の配列が必要です。最初の要素は広告グループ ID です。次のスニペットは、広告グループから 3 つのキーワードを取得します。

let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
    [adGroupId, 234234],
    [adGroupId, 345345],
    [adGroupId, 456456]
]);

広告の取得時にも同じコンストラクトが適用されます。