Расширенные API в скриптах Google Рекламы позволяют разработчикам подключаться к определенным общедоступным API Google с меньшим количеством настроек, чем при использовании их HTTP-интерфейсов. Вы можете использовать эти API так же, как встроенные сервисы скриптов, и они предлагают те же удобства, такие как автозаполнение и автоматическая авторизация.
Примеры использования этих API приведены на странице с фрагментами кода.
Доступные расширенные API
- Google Аналитика
- С помощью Google Аналитики можно отслеживать трафик сайта и корректировать ставки в кампаниях. Если вы свяжете ресурс Google Аналитики с аккаунтом Google Рекламы, то сможете анализировать действия пользователей на вашем сайте. Эта информация поможет вам понять, какая доля трафика и продаж получена благодаря Google Рекламе, и оптимизировать объявления и страницы сайта. Подробнее о том, как связать аккаунты Аналитики и 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 скрипт использует разрешения пользователя, который его авторизовал. Убедитесь, что у пользователя, который авторизовал скрипт, есть доступ ко всем данным, необходимым для его работы. Если вы используете Google Аналитику API, убедитесь, что у пользователя, который авторизовал скрипт, есть необходимые разрешения для аккаунта Аналитики, к которому осуществляется доступ.
Скрипты, созданные до мая 2019 г.
Для скриптов, созданных до мая 2019 года, может потребоваться вручную включить нужные API в связанном облачном проекте Google Cloud. Вы узнаете, затронут ли ваш скрипт, если увидите ссылку на консоль Google Cloud в диалоговом окне расширенных API.
Как включить расширенные API
Для скриптов, созданных до 2019 года, необходимо вручную включить каждый расширенный API, который вы хотите использовать в скрипте.
- Нажмите кнопку Advanced APIs (Расширенные API). В открывшемся диалоговом окне нажмите на ссылку, ведущую в консоль Google Cloud.
- Если ваш проект ещё не выбран, выберите его в раскрывающемся списке "Проект".
- Чтобы найти нужные API, введите их названия в строке поиска.
- Выберите API в результатах поиска и нажмите кнопку "Включить" на следующей странице.
Если пользователь, создавший скрипт, будет удален из аккаунта, то любому новому пользователю, который попытается получить доступ к скрипту, будет предложено снова включить зависимости расширенного API, а также повторно авторизовать скрипт.