Änderungsstrategie

In diesem Leitfaden wird eine genaue Analogie zu den bestehenden Leitfäden für Performance Max-Kampagnen gezeigt, bei denen davon ausgegangen wird, dass Sie die gesamte Kampagne in einer einzigen atomaren Anfrage erstellen, anstatt jede Entität einzeln in separaten Anfragen zu erstellen. Das bedeutet, dass Sie temporäre IDs verwenden müssen, um Ressourcen miteinander zu verknüpfen, da Sie die vollständigen Ressourcennamen erst kennen, wenn Sie die API-Antwort erhalten.

Dazu müssen Sie Code schreiben, damit keine doppelten temporären IDs erstellt werden:

let nextId = -1;

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

Bei jedem weiteren Aufruf von getNextTempId wird eine Zahl eins zurückgegeben, die kleiner als die vorherige Zahl ist. Da alle temporären IDs negativ sein müssen, beginnen Sie bei -1.

Damit können Sie nun ein Array erstellen, das alle Vorgänge enthält:

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 Beispielvorgang finden Sie in der REST-Dokumentation zur Google Ads API.

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

AdsApp.mutateAll(operations);