Новая инфраструктура скриптов Google Ads основана на Google Ads API . Из-за другой архитектуры этого API вам может потребоваться обновить существующие скрипты. Мы приложили все усилия, чтобы обеспечить как можно большую обратную совместимость, поэтому эти изменения должны быть незначительными.
Отчеты
Многие отчеты AWQL продолжат работать. За кулисами, при использовании новой инфраструктуры, сценарии преобразуют ваш запрос AWQL в GAQL (новый язык запросов для Google Ads API), запускают его на новом бэкэнде, а затем преобразуют результаты обратно в формат, первоначально используемый AWQL. отчеты. Запросы с GAQL будут обрабатываться как есть.
Из-за этих накладных расходов мы рекомендуем вам просмотреть свои сценарии и обновить запросы AWQL до GAQL, где это возможно. Вы можете использовать инструмент миграции запросов , который использует ту же логику, что и сценарии, для определения запроса GAQL для данного запроса AWQL, или вы можете использовать интерактивный построитель запросов , чтобы помочь в построении запросов.
Вот некоторые ограничения автоматического перевода AWQL в GAQL:
- Не все запросы AWQL корректно преобразуются в запросы GAQL. В этих случаях будет зарегистрировано сообщение об ошибке с некоторыми подробностями о том, что пошло не так, чтобы помочь вам исправить их вручную.
- Не все типы отчетов из AWQL поддерживаются в GAQL.
- GAQL не поддерживает «строки с нулевым показом». Если указать, что в отчете должно быть нулевое количество показов, возникнет ошибка.
- Некоторые неоднозначные поля нельзя использовать в фильтрах. Например, «Заголовок» может ссылаться на любое количество различных полей объявления.
- Некоторые поля могут возвращать результаты в другом формате, например, разбивая один результат на множество столбцов.
Организация селекторов
При извлечении ресурсов с помощью сценариев довольно часто используются вызовы withCondition и orderBy для ограничения или упорядочивания результатов в итераторе. Поля в этих вызовах теперь используют новые имена API Google Рекламы. Например, чтобы фильтровать по названию кампании, раньше вы использовали:
.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')
Теперь вам следует использовать новые имена полей для этих условий везде, где это возможно:
.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')
Тем не менее, мы постарались включить сопоставление старых имен с новыми именами, поэтому, если ваш сценарий все еще использует CampaignName , он будет автоматически заменен на campaign.name во время выполнения, чтобы гарантировать, что сценарий по-прежнему работает. Если у вас возникнут какие-либо проблемы со старыми именами стилей, обновите свои сценарии, чтобы они использовали новые имена стилей, в качестве первого шага по устранению неполадок.
Пределы
Многие ограничения такие же, как и в старой инфраструктуре, и внесенные здесь изменения обычно помогают повысить производительность.
- Сроки те же. Скрипт может выполняться в течение 30 минут.
- Один итератор по умолчанию возвращает 50 000 объектов, но это можно переопределить. Раньше этот предел в 50 000 нельзя было настраивать.
- Один селектор может обрабатывать не более 10 000 идентификаторов (без изменений).
- Новая инфраструктура не имеет ограничений на количество объектов, которые можно обработать в одном скрипте. Раньше лимит составлял 250 000.
- Новая инфраструктура не имеет ограничений на количество ключевых слов или объявлений, которые можно создать за одно выполнение. Раньше лимит составлял 250 000.
- Выходные данные журнала обрезаются до 100 КБ (без изменений).
- Квоты для служб Apps Script (SpreadsheetApp, MailApp и т. д.) не изменились.
- Квоты для Google Рекламы будут применяться так же, как если бы вы использовали API. То есть на ваш скрипт будут распространяться ограничения скорости API, но это обеспечит большую гибкость при доступе к большему количеству отчетов или внесении большего количества изменений за одно выполнение.
Другие изменения
ExecutionInfo больше не предоставляет getRemainingCreateQuota() или getRemainingGetQuota() , поскольку эти квоты больше не применяются в новом интерфейсе.