Как выполнять вызовы Google Ads API с помощью стратегии mutate

Стратегия изменения подразумевает использование AdsApp.mutate для непосредственного выполнения вызовов API, а не объектов, относящихся к скриптам Google Рекламы. Это позволит вам быстрее получить доступ ко всем функциям API. Кроме того, если вы уже знакомы с синтаксисом API, вам будет проще начать работу.

Как создать кампанию с максимальной эффективностью с помощью метода mutate

В этом руководстве предполагается, что вы создаете всю кампанию в одном атомарном запросе, а не создаете каждый отдельный объект в отдельных запросах. Это означает, что вам нужно будет настроить и использовать временные идентификаторы, чтобы связать ресурсы друг с другом.

Затем создайте массив, в котором будут храниться все операции:

const operations = [];

Вам часто будет нужен идентификатор клиента, для которого вы создаете кампанию, поскольку он требуется в названии каждого ресурса.

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

Каждый раз, когда вы хотите создать новый ресурс, вы будете использовать следующий временный идентификатор в имени ресурса, чтобы вы могли ссылаться на этот объект позже, и вставлять созданный объект в массив:

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

Дополнительную информацию и пример операции можно найти в документации по изменению REST в Google Ads API. Изучите обязательные и необязательные компоненты кампании с максимальной эффективностью и создайте операции, которые вам нужны.

После того как вы создали все операции, выполните их в одном пакете:

AdsApp.mutateAll(operations);