Änderung

Bei der Mutate-Strategie werden API-Aufrufe direkt mit AdsApp.mutate ausgeführt, anstatt auf bestimmte Objekte in Google Ads-Scripts zu setzen. 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. Das ist die einzige Möglichkeit, Suchkampagnen mit Google Ads-Scripts zu ändern.

Suchkampagne mit „mutate“ erstellen

In dieser Anleitung wird davon ausgegangen, dass Sie die gesamte Kampagne in einer einzigen 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 eine neue Ressource 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 Google Ads API REST-Mutate-Methode. Hier erfahren Sie mehr über die erforderlichen und optionalen Komponenten einer Suchkampagne und wie Sie Vorgänge für Ihre Anforderungen erstellen.

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

AdsApp.mutateAll(operations);