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

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

Возможное использование расширенных API

Гугл Аналитика
Вы можете использовать Google Analytics для отслеживания трафика, поступающего на ваш сайт, и соответствующим образом корректировать ставки своей кампании. Если вы свяжете ресурс Google Analytics со своей учетной записью Google Рекламы, вы также сможете анализировать активность клиентов на своем веб-сайте. Эта информация может пролить свет на то, какая часть трафика или продаж вашего веб-сайта приходится на Google Рекламу, и помочь вам улучшить ваши объявления и веб-сайт. Подробнее о связывании аккаунтов Google Analytics и Google Рекламы можно узнать в нашем Справочном центре .
Google BigQuery
Вы можете загружать большие объемы данных в Google Cloud Storage, а затем запрашивать эти данные с помощью Google BigQuery. Например, вы можете загрузить общедоступные данные о погоде за последние 10 лет, а затем запросить среднюю температуру в регионе с помощью скрипта, который использует эту информацию для корректировки ставок. Другим вариантом использования может быть анализ данных об эффективности вашей учетной записи за несколько лет.
YouTube и YouTube Аналитика
Вы можете получать и обновлять свои видео, плейлисты и т. д., а также данные об эффективности ваших видео, чтобы принимать решения о ставках.
Google Календарь
Ваш скрипт может создавать события для будущих задач (например, запускать отчет об эффективности ваших кампаний через две недели) или выполнять действия на основе записи, которую вы создали в своем календаре (например, включать кампанию в определенную дату).
Торговый контент
Ваш скрипт может использовать API контента Google для сценариев покупок в приложениях. Этот API дает пользователям Google Merchant Center возможность загружать и управлять своими списками продуктов, а также управлять своими учетными записями Merchant Center. В сценариях это может быть полезно для проверки списков продуктов и привязки конкретных продуктов к конкретным объявлениям.
Google Задачи
Ваш скрипт может создать список напоминаний для будущих задач (например, запустить отчет об эффективности ваших кампаний через две недели) или выполнить действия на основе записи, которую вы создали в своем списке напоминаний (например, включить кампанию для определенного дата).
Google Презентации
Ваш скрипт может экспортировать информацию о кампании или статистику в Google Slides, чтобы опубликовать такую ​​информацию в презентабельном формате.

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

Чтобы узнать, какие API Google доступны в качестве расширенных API, нажмите кнопку «Расширенные API» на верхней панели редактора.

Откроется диалоговое окно «Расширенные API» . Проверьте API, которые вы хотите включить.

Затем щелкните ссылку Консоль Google API , чтобы открыть в консоли страницу консоли API с проектом, связанным с вашим скриптом; или, если ваш проект еще не выбран, выберите его из раскрывающегося списка «Проект». Найдите API, которые вы хотите использовать в своем скрипте, введя имя API в строке поиска.

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

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

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

Доступные API

Для использования доступны следующие API:

Имя API Документация
Гугл Аналитика https://developers.google.com/apps-script/advanced/analytics
Google BigQuery https://developers.google.com/apps-script/advanced/bigquery
Google Календарь https://developers.google.com/apps-script/advanced/calendar
Google Презентации https://developers.google.com/apps-script/advanced/slides
Google Задачи https://developers.google.com/apps-script/advanced/tasks
Торговый контент https://developers.google.com/apps-script/advanced/shopping-content
YouTube https://developers.google.com/apps-script/advanced/youtube
YouTube Аналитика https://developers.google.com/apps-script/advanced/youtube-analytics

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

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

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

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

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

Зависимости

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

Разрешения

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

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

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

Квота

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

Биллинг

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