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

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

Как создать кампанию для создания спроса с помощью метода 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);