Änderungsstrategie

In dieser Anleitung wird eine genaue Analogie zu den vorhandenen Performance Max-Anleitungen erstellt. Dort wird davon ausgegangen, dass Sie die gesamte Kampagne in einer einzigen atomaren Anfrage erstellen, anstatt jedes Element einzeln in separaten Anfragen zu erstellen. Du musst also vorübergehende IDs verwenden, um Ressourcen miteinander zu verknüpfen, da du die vollständigen Ressourcennamen erst kennst, wenn du die API-Antwort erhältst.

Dazu müssen Sie Code schreiben, um zu verhindern, dass doppelte temporäre IDs erstellt werden:

let nextId = -1;

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

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

Jetzt können Sie 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 Beispiel für einen Vorgang finden Sie in der REST-API-Dokumentation zur Google Ads API-Mutation.

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

AdsApp.mutateAll(operations);