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

Расширенные 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 Google» , чтобы открыть страницу консоли API в консоли, где будет указан проект, связанный с вашим скриптом; или, если ваш проект еще не выбран, выберите его из раскрывающегося списка «Проект». Найдите API, которые вы хотите использовать в своем скрипте, введя имя API в строку поиска.

В результатах поиска выберите API, а на следующей странице нажмите «Включить» ; если вы видите кнопку «Отключить» , значит, этот API уже включен. Повторите это действие для каждого API, который вы хотите включить.

Чтобы просмотреть список включенных API для проекта, выберите страницу «Панель управления» . Убедитесь, что в списке отображаются все расширенные API, которые вы хотите использовать для скрипта.

Теперь закройте диалоговое окно «Расширенные API», чтобы вернуться в редактор. Новые API будут включены для вашего скрипта и появятся в списке автозаполнения.

Заключительные соображения

При работе с расширенными API следует учитывать несколько моментов.

Идентификатор проекта

Каждому скрипту Google Ads присваивается идентификатор проекта Google Cloud (также известный как номер проекта). Номер проекта вашего скрипта можно найти, открыв страницу консоли Google API в диалоговом окне «Расширенные API» . Этот идентификатор проекта создается при создании скрипта и привязан к пользователю, создавшему скрипт Google Ads. Если пользователь, создавший скрипт, впоследствии удаляется из учетной записи, пользователю, пытающемуся получить доступ к скрипту, будет предложено повторно авторизовать скрипт и настроить зависимости расширенных API. Также будет создан новый идентификатор проекта Google Developer, и вам потребуется снова настроить расширенные API, как описано ранее в этом документе.

Зависимости

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

Разрешения

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

Условия и положения

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

Квота

Большинство расширенных API имеют связанную с ними бесплатную ежедневную квоту. Как только ваш скрипт превысит эту квоту, API перестанет работать, пока вы не запросите дополнительные данные или бесплатная квота не будет пополнена. Вы можете отслеживать использованную вашим скриптом квоту, открыв консоль Google API для скрипта в диалоговом окне «Расширенные API» . Консоль Google API также предоставляет вам возможность запросить дополнительную квоту для API.

Выставление счетов

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