Расширенные API в скриптах Google Ads позволяют разработчикам подключаться к некоторым общедоступным API Google с меньшими затратами на настройку, чем при использовании их HTTP-интерфейсов. Вы можете использовать эти API так же, как и встроенные сервисы скриптов, и они предлагают те же удобства, такие как автозаполнение и автоматическая авторизация.
Примеры использования этих API можно найти на нашей странице с фрагментами кода .
Доступные расширенные API
- Google Аналитика
- Вы можете использовать Google Analytics для отслеживания трафика на вашем веб-сайте и соответствующей корректировки ставок в ваших рекламных кампаниях. Если вы свяжете ресурс Google Analytics со своим аккаунтом Google Ads, вы также сможете анализировать активность клиентов на вашем веб-сайте. Эта информация поможет понять, какая часть трафика или продаж вашего веб-сайта поступает из Google Ads, и поможет вам улучшить ваши объявления и веб-сайт. Подробнее о связывании аккаунтов Analytics и Google Ads можно узнать в руководстве «Настройка Analytics для веб-сайта и/или приложения» в Справочном центре.
- Google BigQuery
- В Google Cloud Storage можно загружать большие объемы данных, а затем запрашивать их с помощью Google BigQuery. Например, можно загрузить общедоступные данные о погоде за последние 10 лет, а затем запросить среднюю температуру в определенном регионе с помощью скрипта, который будет использовать эту информацию для корректировки ставок. Другой вариант — обработка данных о производительности вашего аккаунта за несколько лет.
- Календарь Google
- Ваш скрипт может создавать события для будущих задач (например, запустить отчет о производительности ваших кампаний через 2 недели) или выполнять действия на основе записи, созданной вами в календаре (например, активировать кампанию в определенную дату).
- Google Слайды
- Ваш скрипт может экспортировать подробную информацию о кампании или статистику в Google Slides для публикации таких данных в удобном для просмотра формате.
- Задачи Google
- Ваш скрипт может создавать список напоминаний для будущих задач (например, запускать отчет о производительности ваших кампаний через две недели) или выполнять действия на основе записи, созданной вами в списке напоминаний (например, активировать кампанию в определенную дату).
- API для продавцов
- Ваш скрипт может использовать Merchant API для загрузки и управления списками товаров, а также для управления вашими учетными записями Google Merchant Center. В скриптах это может быть полезно для проверки списков товаров и привязки определенных товаров к определенным объявлениям. Merchant API имеет под-API, которые можно включить по отдельности в диалоговом окне «Расширенные API» . Подробнее о привязке вашей учетной записи Google Merchant Center можно узнать в руководстве по регистрации в качестве разработчика .
- Контент для покупок
- Ваш скрипт может использовать Google Content API для покупок, чтобы загружать и управлять списками товаров, а также управлять своими учетными записями Google Merchant Center. В скриптах это может быть полезно для проверки списков товаров и привязки определенных товаров к определенным объявлениям. Примечание: поддержка Content API для покупок будет прекращена 18 августа 2026 года. Вместо него используйте Merchant API, описанный в предыдущем разделе.
- YouTube и аналитика YouTube
- Вы можете получать и обновлять свои видео, плейлисты и т. д., а также данные об эффективности ваших видео, чтобы принимать решения о назначении ставок.
Включите расширенные API
Чтобы узнать, какие API Google доступны в качестве расширенных API, нажмите «Расширенные API» в верхней панели редактора, чтобы открыть диалоговое окно «Расширенные API» . Выберите API, которые вы хотите включить.
Нажмите «Сохранить» , чтобы сохранить выбранные параметры и вернуться в редактор скриптов. Новые API будут включены для вашего скрипта и станут доступны в списке автозаполнения.
Дополнительные соображения
При работе со сложными API следует учитывать несколько моментов.
Зависимости
Изменять зависимости расширенных API для этого скрипта может только пользователь, создавший скрипт в данной учетной записи.
Разрешения
При доступе к API скрипт использует права доступа пользователя, который его авторизовал. Убедитесь, что пользователь, авторизовавший скрипт, имеет необходимый доступ ко всем данным, которые ему требуются. Если вы используете API Google Analytics, убедитесь, что пользователь, авторизовавший скрипт, имеет необходимые права доступа к учетной записи Analytics, к которой осуществляется доступ.
Рассмотрение сценариев, написанных до мая 2019 года.
Для скриптов, созданных до мая 2019 года, может потребоваться вручную включить соответствующие API в связанном с скриптом проекте Google Cloud. Вы поймете, что ваш скрипт затронут, если в диалоговом окне расширенных настроек API появится ссылка на консоль Google Cloud.
Включите расширенные API
Для скриптов, созданных до 2019 года, вам потребуется вручную включить каждый расширенный API, который вы хотите использовать в своем скрипте:
- Нажмите кнопку «Расширенные API» . В появившемся диалоговом окне перейдите по ссылке на консоль Google Cloud.
- Если ваш проект еще не выбран, выберите его из выпадающего списка «Проект».
- Найдите нужные вам API, введя название API в строку поиска.
- Выберите API из результатов поиска и нажмите кнопку «Включить» на следующей странице.
Если пользователь, создавший скрипт, впоследствии будет удален из учетной записи, то любому новому пользователю, пытающемуся получить доступ к скрипту, будет предложено повторно включить расширенные зависимости API, а также повторно авторизовать скрипт.