Из этой статьи вы узнаете, как управлять связыванием аккаунтов 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. Чтобы создать объект службы, обычно нужно выполнить следующие действия:
- Зарегистрируйте приложение в Google Developers Console.
- Разрешите доступ к Google Analytics.
- Создайте объект службы Google Analytics.
Если вы не выполнили эти действия, перед продолжением прочитайте вводное руководство по Google Analytics API, в котором описывается, с чего нужно начинать создание приложения на его основе. Это поможет вам использовать Google Analytics API для работы с реальными приложениями.
Примеры использования
Из этого раздела вы узнаете, как автоматизировать следующие задачи:
- Как вывести список всех связей между аккаунтами Google Analytics и Google AdWords для ресурса
- Как создать новую связь между аккаунтами Google Analytics и Google AdWords
- Как удалить связь между аккаунтами Google Analytics и Google AdWords
- Как добавить или привязать представление (профиль) к существующей связи между аккаунтами Google Analytics и Google AdWords
- Как удалить представление (профиль) из связи между аккаунтами Google Analytics и Google AdWords
Как вывести список всех связей между аккаунтами Google Analytics и Google AdWords для ресурса
Выполните следующие действия:
- С помощью Management API или веб-интерфейса получите идентификаторы аккаунта и ресурса.
- Выполните метод
list
ресурсаentityAdWordsLinks
.
Как создать новую связь между аккаунтами Google Analytics и Google AdWords
Выполните следующие действия:
- С помощью AdWords API или веб-интерфейса получите идентификатор клиента.
- С помощью Management API или веб-интерфейса получите идентификаторы аккаунта и ресурса, с которыми требуется связать аккаунт Google AdWords.
- Выполните метод
insert
ресурсаentityAdWordsLinks
, чтобы создать связь между аккаунтами Google AdWords и Google Analytics.
Как удалить связь между аккаунтами Google Analytics и Google AdWords
Выполните следующие действия:
- С помощью Google Analytics Management API или веб-интерфейса получите идентификаторы аккаунта и ресурса, связь с которыми требуется удалить.
- С помощью Management API получите идентификатор ссылки AdWords.
- Выполните метод
delete
ресурсаentityAdWordsLinks
, чтобы удалить ссылку.
Как добавить представление (профиль) к существующей связи между аккаунтами Google Analytics и Google AdWords
Чтобы использовать данные Google AdWords в отчетах для представления (профиля):
- С помощью Google Analytics Management API или веб-интерфейса получите идентификаторы аккаунта, ресурса и представления (профиля).
- С помощью Management API получите идентификатор ссылки AdWords, к которой будет привязано представление (профиль).
- Выполните метод
patch
ресурсаentityAdWordsLinks
, чтобы добавить представление (профиль).
Как удалить представление (профиль) из связи между аккаунтами Google Analytics и Google AdWords
Чтобы отменить связь и удалить данные Google AdWords из отчетов для представления (профиля):
- С помощью Google Analytics Management API или веб-интерфейса получите идентификаторы аккаунта, ресурса и представления (профиля).
- С помощью Management API получите идентификатор ссылки AdWords, к которой привязано нужное представление (профиль).
- Выполните метод
get
ресурсаentityAdWordsLinks
и получите список идентификаторов профилей для ссылки AdWords. - Удалите идентификатор профиля из списка, полученного на предыдущем шаге.
- Выполните метод
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.