IDs

Die meisten Google Ads-Entitäten stellen eine getId()-Methode bereit, die ihre Kennung zurückgibt. In den meisten Fällen ist das nicht unbedingt erforderlich, aber IDs können in folgenden Situationen nützlich sein:

Mit Berichten arbeiten
Mithilfe von IDs können Sie eine Berichtszeile mit der tatsächlichen Google Ads-Entität verknüpfen.
Zuordnung mit einem externen Datenspeicher verwalten
Möglicherweise sind bereits ID-basierte Informationen in Ihrer eigenen Datenbank gespeichert.
Beim Versuch, die Leistung zu steigern

Das Abrufen nach IDs geht häufig schneller als alternative Vorgehensweisen. Auch der Code zum Abrufen einer einzelnen Entität ist etwas einfacher:

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

Eindeutigkeit

Kampagnen-IDs und Anzeigengruppen-IDs sind eindeutig. Zwei Kampagnen oder Anzeigengruppen haben niemals dieselbe ID. Anzeigen und Keywords haben jedoch zusammengesetzte IDs. Eine eindeutige Kennung eines Keywords ist eine Kombination aus seiner Anzeigengruppen-ID und Keyword-ID. Ebenso ist eine eindeutige Kennung einer Anzeige eine Kombination aus ihrer Anzeigengruppen-ID und Anzeigen-ID. Dies hat Auswirkungen auf die Art und Weise, wie selector.withIds() aufgerufen wird.

Für Kampagnen und Anzeigengruppen erwartet selector.withIds() ein Array von Zahlen:

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

Für Anzeigen und Keywords benötigt selector.withIds() jedoch ein Array von Arrays mit zwei Elementen, wobei das erste Element die Anzeigengruppen-ID ist. Mit dem folgenden Snippet werden drei Keywords aus einer Anzeigengruppe abgerufen:

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

Dasselbe Konstrukt gilt beim Abrufen von Anzeigen.

Temporäre IDs

Wenn Sie mit einer Mutationsanfrage mit mehreren Vorgängen arbeiten, müssen Sie gelegentlich temporäre IDs verwenden, um Ressourcen miteinander zu verknüpfen. Die vollständigen Ressourcennamen sind erst verfügbar, wenn Sie die API-Antwort erhalten. Temporäre IDs müssen negative Zahlen sein, die mit -1 beginnen, und dürfen in derselben Mutationsanfrage nicht wiederholt werden. Damit Sie temporäre IDs effektiv verwenden können, müssen Sie etwas Code schreiben, um zu verhindern, dass doppelte temporäre IDs erstellt werden:

let nextId = -1;

function getNextTempId() {
    const ret = nextId;
    nextId -= 1;
    return ret;
}

Jeder nachfolgende Aufruf von getNextTempId gibt eine Zahl zurück, die um eins kleiner ist als die vorherige. Da alle temporären IDs negativ sein müssen, beginnen Sie mit -1.

Temporäre IDs werden nicht über Jobs oder Mutationsanfragen hinweg gespeichert. Wenn Sie auf eine Ressource verweisen möchten, die in einer vorherigen Mutationsanfrage erstellt wurde, verwenden Sie den tatsächlichen Ressourcennamen.