Изменения формата в Google Ads API

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Формат идентификатора клиента

В AdWords API вы можете указать свой идентификатор клиента либо в виде 10-значного числа, либо в виде строки в формате XXX-XXX-XXXX. Теперь в Google Ads API вы должны указать свой идентификатор клиента в виде 10-значного числа без дефисов.

Формат запроса

В AdWords API запросы можно было делать с помощью языка запросов или XML-селектора. Теперь в API Google Ads тип запроса, который вы делаете, диктует определенный формат запроса.

При поиске, который вы бы сделали, чтобы найти список объектов, соответствующих определенному набору критериев, используйте язык запросов Google Реклама , чтобы сделать запрос к GoogleAdsService . Для этого варианта использования не поддерживается ни один параметр селектора, и все поиски выполняются в одной и той же службе, независимо от типа объекта.

Получать

При получении всех сведений для определенного объекта, скажем, кампании, используйте соответствующий сервис (в данном случае CampaignService ) и укажите имя ресурса объекта, который вы хотите получить. Например, название ресурса кампании имеет вид /customers/XXXXXXXXXX/campaigns/YYYYYYYYYY , где XXXXXXXXXX – идентификатор вашего клиента без дефисов, а YYYYYYYYYY – идентификатор кампании.

Мутировать

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

В API AdWords изменяющие вызовы после завершения возвращали бы новое состояние объекта. Теперь в Google Ads API вызовы mutate возвращают только имя ресурса измененного объекта. Если вы хотите проверить измененное состояние объекта, сделайте еще один вызов API, чтобы получить объект.

Для вызовов мутации требуется операция, которая принимает один из трех возможных параметров:

Создавать
Требуется, чтобы вы передали завершенный объект, включая его имя ресурса, все обязательные поля и любые необязательные поля, которые вы хотите установить.
Обновлять

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

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

Удалять

Требуется только имя ресурса.

Формат ответа

В AdWords API поиск и выборка полей для сущностей были одним и тем же, но в Google Ads API это уже не так. Разница в параметрах запроса также приводит к разнице в форматах ответов для двух действий.

При поиске с использованием GoogleAdsService ответы будут включать одну GoogleAdsRow для каждого объекта, соответствующего параметрам поиска. Каждая строка содержит один объект, например кампанию, и в этом объекте заполняются только те поля, которые вы специально запросили в своем запросе.

При извлечении с использованием определенного сервиса, например CampaignService , вы можете запрашивать только один объект за раз по имени ресурса, и все поля для этого объекта будут заполнены в ответе.