Management API: руководство по ссылкам AdWords для разработчиков

Из этой статьи вы узнаете, как управлять связыванием аккаунтов Google AdWords и Google Analytics для авторизованного пользователя с помощью Management API.

Введение

С помощью ссылок AdWords в Management API вы можете получать, выводить список, создавать, обновлять и удалять связи между ресурсами аккаунтов Google AdWords и Google Analytics, а также задавать представления (профили), в которые будут добавляться данные AdWords.

Подробнее о способах и преимуществах связывания аккаунтов читайте в соответствующих статьях Справочного центра Google AdWords и Google Analytics.

Подготовка к работе

Доступ ко всем Google Analytics API осуществляется одинаково. Прежде чем начать работу с Management API, ознакомьтесь со следующими материалами:

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

В каждой библиотеке реализован один объект службы Google Analytics, который обеспечивает доступ ко всем данным Management API. Чтобы создать объект службы, обычно нужно выполнить следующие действия:

  1. Зарегистрируйте приложение в Google Developers Console.
  2. Разрешите доступ к Google Analytics.
  3. Создайте объект службы Google Analytics.

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

Примеры использования

Из этого раздела вы узнаете, как автоматизировать следующие задачи:

Как вывести список всех связей между аккаунтами Google Analytics и Google AdWords для ресурса

Выполните следующие действия:

  1. С помощью Management API или веб-интерфейса получите идентификаторы аккаунта и ресурса.
  2. Выполните метод list ресурса entityAdWordsLinks.

Подробнее об этом методе…

Как создать новую связь между аккаунтами Google Analytics и Google AdWords

Выполните следующие действия:

  1. С помощью AdWords API или веб-интерфейса получите идентификатор клиента.
  2. С помощью Management API или веб-интерфейса получите идентификаторы аккаунта и ресурса, с которыми требуется связать аккаунт Google AdWords.
  3. Выполните метод insert ресурса entityAdWordsLinks, чтобы создать связь между аккаунтами Google AdWords и Google Analytics.

Подробнее об этом методе…

Выполните следующие действия:

  1. С помощью Google Analytics Management API или веб-интерфейса получите идентификаторы аккаунта и ресурса, связь с которыми требуется удалить.
  2. С помощью Management API получите идентификатор ссылки AdWords.
  3. Выполните метод delete ресурса entityAdWordsLinks, чтобы удалить ссылку.

Подробнее об этом методе…

Как добавить представление (профиль) к существующей связи между аккаунтами Google Analytics и Google AdWords

Чтобы использовать данные Google AdWords в отчетах для представления (профиля):

  1. С помощью Google Analytics Management API или веб-интерфейса получите идентификаторы аккаунта, ресурса и представления (профиля).
  2. С помощью Management API получите идентификатор ссылки AdWords, к которой будет привязано представление (профиль).
  3. Выполните метод patch ресурса entityAdWordsLinks, чтобы добавить представление (профиль).

Подробнее об этом методе…

Как удалить представление (профиль) из связи между аккаунтами Google Analytics и Google AdWords

Чтобы отменить связь и удалить данные Google AdWords из отчетов для представления (профиля):

  1. С помощью Google Analytics Management API или веб-интерфейса получите идентификаторы аккаунта, ресурса и представления (профиля).
  2. С помощью Management API получите идентификатор ссылки AdWords, к которой привязано нужное представление (профиль).
  3. Выполните метод get ресурса entityAdWordsLinks и получите список идентификаторов профилей для ссылки AdWords.
  4. Удалите идентификатор профиля из списка, полученного на предыдущем шаге.
  5. Выполните метод patch ресурса entityAdWordsLinks, чтобы удалить представление (профиль) с использованием этого списка.

Подробнее о методе get ресурса entityAdWordsLinks

Примеры кода

С помощью ресурса AdWords Links авторизованный пользователь может получать, удалять, обновлять (в том числе и согласно семантике PATCH) и добавлять ссылки AdWords, а также выводить их список. Для работы с этими методами вам потребуется объект службы Google Analytics, создание которого описывается в этом разделе.

Примеры кода, демонстрирующие работу со ссылками AdWords, вы найдете в справке по соответствующим методам.

Как управлять ссылками AdWords

  • list – выводит список доступных пользователю ссылок AdWords.
  • get – получает доступную пользователю ссылку AdWords.
  • insert – создает новую ссылку AdWords.
  • patch – обновляет существующую ссылку AdWords (поддерживается семантика PATCH).
  • update – обновляет существующую ссылку AdWords.
  • delete – удаляет существующую ссылку AdWords.