Работа с расширенными API

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

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

Google Analytics
Вы можете использовать Google Analytics для отслеживания трафика, поступающего на сайт, и корректировать ставки для кампаний с учетом полученных данных. Связав ресурс Google Analytics с аккаунтом AdWords, вы также сможете анализировать поведение пользователей на сайте. Эта информация позволит понять, какая доля трафика и продаж получена благодаря AdWords, а затем оптимизировать объявления и веб-страницы. Подробнее о связывании аккаунтов читайте в Справочном центре.
Google BigQuery
Вы можете загрузить огромный объем данных в Google Cloud Storage, а затем обрабатывать их с помощью сервиса Google BigQuery. Например, можно загрузить общедоступные данные о погоде за 10 лет, а затем запросить среднюю температуру по региону с помощью скрипта, который использует эту информацию для корректировки ставок. Ещё можно проанализировать эффективность аккаунта за несколько лет.
YouTube и YouTube –Analytics
Вы можете извлекать и обновлять данные о видео, плейлистах и других ресурсах, а также получать сведения по эффективности для корректировки ставок
Google Календарь
Скрипт может создавать события для будущих задач (например, создавать отчет по эффективности кампаний через 2 недели) или выполнять действия с учетом записей в календаре (например, запускать кампанию в определенный день).
Shopping Content
Можно использовать Google Content API for Shopping в скрипте приложений Google Apps. Этот API предоставляет пользователям Google Merchant Center, возможность загружать информацию о товаре и управлять ей, а также выполнять действия с аккаунтами Merchant Center.
Google Задачи
Скрипт может создавать напоминания для будущих задач (например, создавать отчет по эффективности кампаний через 2 недели) или выполнять действия с учетом записей в календаре (например, запускать кампанию в определенный день).
Google Prediction
Вы можете использовать собранную статистику для обучения системы и проведения анализа трендов. Например, если вы – владелец аптеки и у вас есть статистика по температуре воздуха и продажам лекарств от простуды за каждый день, вы можете создать модель в системе Google Prediction и использовать ее для прогнозирования продаж в определенный сезон. Это вариант и для тех, кто продает теплую одежду. Прогноз погоды и статистика по продажам помогут вам скорректировать ставки и бюджет.

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

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

Откроется диалоговое окно Расширенные API. Найдите в списке подходящие варианты.

Затем нажмите на ссылку Google API Console, чтобы открыть в консоли страницу Диспетчер API с проектом, связанным со скриптом (если проект не выбран, его нужно выбрать в раскрывающемся списке "Проект"). Чтобы найти API для использования в скрипте, укажите его название на панели поиска.

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

Чтобы просмотреть список включенных API, откройте вкладку Включенные API на странице "Обзор". Убедитесь, что там перечислены все расширенные API, которые нужно использовать.

Закройте диалоговое окно, чтобы вернуться к редактору. Новые API будут доступны в скрипте и добавлены в список автозаполнения.

Какие API доступны?

В настоящее время доступны перечисленные ниже API.
Название API Документация
Google Analytics 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/fusion-tables
Google Prediction https://developers.google.com/apps-script/advanced/prediction
Shopping Content https://developers.google.com/apps-script/advanced/shopping-content
Google Задачи https://developers.google.com/apps-script/advanced/tasks
YouTube https://developers.google.com/apps-script/advanced/youtube
YouTube Analytics https://developers.google.com/apps-script/advanced/youtube-analytics

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

Дополнительные сведения

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

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

У каждого скрипта AdWords есть идентификатор проекта, также называемый номером проекта. Чтобы узнать его, перейдите на страницу Google Developers Console из диалогового окна Расширенные API. Идентификатор проекта создается, когда вы создаете скрипт AdWords, и по нему можно понять, кто автор. Если пользователь, создавший скрипт, будет впоследствии удален из аккаунта, при попытке получить доступ к скрипту потребуется повторная авторизация и настройка расширенных API. Также будет создан новый идентификатор проекта.

Изменение настроек расширенных API

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

Разрешения скрипта

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

Условия использования

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

Квота

Большинство расширенных API имеют ограничения по объему бесплатно обрабатываемых данных в день. После превышения этого ограничения API перестанет работать, пока не начнется следующий день или вы не запросите платное использование. Отслеживать квоты можно в Google Developers Console, просто открыв диалоговое окно Расширенные API. Google Developers Console также позволяет запрашивать расширение квоты для API.

Оплата

Некоторые расширенные API требуют платы за использование. Оплата осуществляется через проект Google Developers Console, связанный с вашим скриптом, а не через AdWords. Подробнее о включении оплаты в проекте Google Developers Console для вашего скрипта читайте здесь.

Оставить отзыв о...

Текущей странице
Скрипты AdWords
Скрипты AdWords