Расширенные API

Расширенные API в скриптах Google Рекламы позволяют разработчикам подключаться к определенным общедоступным API Google с меньшим количеством настроек, чем при использовании их HTTP-интерфейсов. Вы можете использовать эти API так же, как встроенные сервисы скриптов, и они предлагают те же удобства, такие как автозаполнение и автоматическая авторизация.

Примеры использования этих API приведены на странице с фрагментами кода.

Доступные расширенные API

Google Аналитика
Примечание. Расширенный API Analytics в диалоговом окне Advanced APIs (Расширенные API) предназначен для отключенного Universal Analytics v3 API, и запросы к нему не выполняются. Скрипты Google Рекламы не поддерживают расширенные сервисы Google Аналитики 4 AnalyticsData и AnalyticsAdmin. Чтобы запросить данные Google Аналитики 4 из скрипта, отправьте HTTPS-запросы в Google Analytics Data API с помощью сервиса UrlFetchApp и OAuth 2.0. Вы также можете связать ресурс Google Аналитики 4 с аккаунтом Google Рекламы, чтобы напрямую передавать данные о конверсиях на сайте и в приложении. Инструкции по настройке вы найдете в руководстве по настройке Аналитики.
Google BigQuery
Вы можете загружать большие объемы данных в Google Cloud Storage, а затем запрашивать их с помощью Google BigQuery. Например, вы можете загрузить общедоступные данные о погоде за последние 10 лет, а затем запросить среднюю температуру в регионе в скрипте, который использует эту информацию для корректировки ставок. Ещё один вариант – обработка данных об эффективности аккаунта за несколько лет.
Google Календарь
Скрипт может создавать мероприятия для будущих задач (например, запустить отчет об эффективности кампаний через две недели) или выполнять действия на основе записи, созданной в календаре (например, включить кампанию в определенную дату).
Google Презентации
Скрипт может экспортировать сведения о кампаниях или статистику в Google Презентации, чтобы вы могли опубликовать эту информацию в удобном формате.
Google Задачи
Скрипт может создать список напоминаний о будущих задачах (например, создать отчет об эффективности кампаний через две недели) или выполнить действия на основе записи, созданной в списке напоминаний (например, включить кампанию в определенную дату).
Merchant API
С помощью Merchant API скрипт может загружать информацию о товарах и управлять ею, а также управлять аккаунтами Google Merchant Center. В скриптах это может быть полезно для проверки списков товаров и связывания определенных товаров с определенными объявлениями. Merchant API содержит дочерние API, которые можно включить по отдельности в диалоговом окне Advanced APIs (Расширенные API). Подробнее о том, как связать аккаунт Google Merchant Center, рассказывается в руководстве Регистрация в качестве разработчика.
Торговый контент
Скрипт может использовать Google Content API for Shopping, чтобы загружать информацию о товарах и управлять ею, а также управлять аккаунтами Google Merchant Center. В скриптах это может быть полезно для проверки списков товаров и связывания определенных товаров с определенными объявлениями. Примечание. Поддержка Content API for Shopping прекратится 18 августа 2026 г. Вместо него используйте Merchant API, описанный в предыдущем разделе.
YouTube и YouTube Аналитика
Вы можете получать и обновлять информацию о своих видео, плейлистах и т. д., а также данные об эффективности видео, чтобы принимать решения о ставках.

Как включить расширенные API

Чтобы посмотреть, какие API Google доступны в качестве расширенных, нажмите Расширенные API на верхней панели редактора. Откроется диалоговое окно Расширенные API. Выберите API, которые хотите включить.

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

В видео есть другие нарушения?

При работе с расширенными API необходимо учитывать следующее:

Зависимости

Изменить зависимости расширенных API для скрипта может только пользователь, который создал этот скрипт в аккаунте.

Разрешения

При доступе к расширенным API скрипт использует разрешения пользователя, который авторизовал скрипт. У пользователя, предоставляющего разрешение, должен быть необходимый доступ ко всем данным, которые нужны скрипту. Например, чтобы использовать расширенный API BigQuery, у авторизующегося пользователя должны быть необходимые разрешения для целевого облачного проекта Google Cloud и набора данных BigQuery.

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

Для скриптов, созданных до мая 2019 года, может потребоваться вручную включить нужные API в связанном облачном проекте Google Cloud. Вы узнаете, затронут ли ваш скрипт, если увидите ссылку на консоль Google Cloud в диалоговом окне расширенных API.

Как включить расширенные API

Для скриптов, созданных до 2019 года, вам нужно вручную включить каждый расширенный API, который вы хотите использовать в скрипте:

  1. Нажмите кнопку Advanced APIs (Расширенные API). В открывшемся диалоговом окне нажмите на ссылку, ведущую в консоль Google Cloud.
  2. Если ваш проект не выбран, выберите его в раскрывающемся списке Project (Проект).
  3. Найдите нужные API, введя их названия в строке поиска.
  4. Выберите API в результатах поиска и нажмите кнопку "Включить" на следующей странице.

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