Google Ads API-Aufrufe mit der Mutate-Strategie ausführen

Bei der Mutate-Strategie werden API-Aufrufe direkt mit AdsApp.mutate ausgeführt, anstatt auf bestimmte Objekte in Google Ads-Scripts zurückzugreifen. So können Sie schneller auf alle Funktionen der API zugreifen. Außerdem ist der Einstieg einfacher, wenn Sie bereits mit der API-Syntax vertraut sind.

Performance Max-Kampagne mit „mutate“ erstellen

In dieser Anleitung wird davon ausgegangen, dass Sie die gesamte Kampagne in einer einzelnen atomaren Anfrage erstellen und nicht jede einzelne Einheit in separaten Anfragen. Das bedeutet, dass Sie temporäre IDs einrichten und verwenden müssen, um Ressourcen miteinander zu verknüpfen.

Erstellen Sie nun ein Array, in dem alle Vorgänge gespeichert werden:

const operations = [];

Sie benötigen häufig die Kundennummer des Kunden, für den Sie die Kampagne erstellen, da sie in jedem Ressourcennamen erforderlich ist.

const customerId = AdsApp.currentAccount().getCustomerId();

Jedes Mal, wenn Sie einen neuen Vorgang erstellen möchten, verwenden Sie die nächste temporäre ID im Ressourcennamen, damit Sie später auf dieses Objekt verweisen und das erstellte Objekt in das Array einfügen können:

const newOperation = {
    [OPERATION_TYPE_VARIES]: {
        create: {
            resourceName: `customers/${customerId}/[EXACT_PATH_VARIES]/${getNextTempId()}`
            // Other fields, relevant to the resource being created.
        }
    }
}
operations.push(newOperation);

Weitere Informationen und ein Beispiel für einen Vorgang finden Sie in der Dokumentation zur REST-Mutate-Methode der Google Ads API. Erforderliche und optionale Komponenten einer Performance Max-Kampagne und Erstellen von Vorgängen für Ihre Anforderungen.

Nachdem Sie alle Vorgänge erstellt haben, führen Sie sie in einem einzelnen Batch aus:

AdsApp.mutateAll(operations);