Настройте доступ к API

Вот как настроить доступ к API Data Manager с помощью SDK или REST.

Выберите тип процесса настройки, которому вы хотите следовать:

Предварительные требования

Прежде чем использовать API данных, убедитесь, что у вас есть следующее:

  1. Проект Google Cloud .
  2. Для доступа к вашему проекту Google Cloud требуется учетная запись Google, имеющая разрешение serviceusage.services.enable , или роль, включающая это разрешение. Например, roles/owner и roles/serviceusage.serviceUsageAdmin содержат разрешение serviceusage.services.enable . Чтобы проверить свои разрешения, см. раздел «Просмотр текущего доступа» .
  3. Установлен интерфейс командной строки Google Cloud.

Включить API

If you haven't already, enable the Data Manager API by clicking Enable the Data Manager API or follow the instructions to perform this step manually.

Включите API менеджера данных.

If you can't find the Data Manager API or Enable the Data Manager API fails, verify your Google Account meets the prerequisites .

Настройка аутентификации

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

Два распространенных метода аутентификации — это учетные записи пользователей и служебные учетные записи :

  • Учетные записи пользователей : представляют людей, которые напрямую взаимодействуют с API и сервисами Google.
  • Служебные учетные записи : представляют приложения, а не людей, в качестве пользователей. Они позволяют вашим приложениям управлять аутентификацией и авторизацией. Например, если приложению необходимо получить доступ к ресурсам Google Cloud.

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

Для настройки ADC выберите имитацию учетной записи пользователя или служебной учетной записи:

Вот шаги для аутентификации с использованием учетных данных пользователя :

  1. Настройте параметры платформы аутентификации Google для вашего проекта.

    1. Откройте страницу «Брендинг» в консоли Google Cloud.

    2. Выберите свой проект.

    3. Заполните форму и нажмите «Создать» .

  2. Поскольку область действия API Data Manager является конфиденциальной , необходимо выполнить следующие шаги:

    1. Перейдите в настройки доступа к данным для вашего проекта.

    2. Нажмите «Добавить или удалить области действия» .

    3. Установите флажок рядом с пунктом «API менеджера данных» в списке областей действия и нажмите «Обновить» .

    4. Нажмите « Сохранить ».

    5. Перейдите в раздел «Аудитория» в консоли Google Cloud и обновите статус публикации и тип пользователя . Подробнее об этих настройках см. в разделе «Управление аудиторией приложений» .

  3. Нажмите «Создать клиент OAuth2» , чтобы создать клиент OAuth2 в проекте, или следуйте инструкциям для создания настольного клиента OAuth2. Вы можете пропустить этот шаг, если у вас уже есть настольный клиент OAuth2, который вы хотите использовать для API Data Manager.

    Если вы нажмете «Создать клиент OAuth2» , при появлении запроса выберите « Настроить настольное приложение» , чтобы использовать клиент на следующих шагах.

    Создание клиента OAuth2

    На последнем шаге нажмите кнопку СКАЧАТЬ КОНФИГУРАЦИЮ КЛИЕНТА и запомните выбранное вами место для загрузки.

  4. Создайте локальный файл ADC, выполнив следующую команду. Эта команда запускает веб-процесс, в котором вам будет предложено войти в учетную запись Google, которую вы используете с API.

    Замените PATH_TO_CLIENT_JSON на имя загруженного вами JSON-файла.

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Если вы хотите использовать одни и те же учетные данные для API Data Manager и API Google Ads , добавьте область действия API Google Ads в список --scopes :

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Если вы хотите использовать одни и те же учетные данные для API Data Manager и API Display & Video 360 , добавьте область действия API Display & Video 360 в список --scopes :

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. Подтвердите правильность настройки учетных данных с помощью следующей команды. В случае успеха команда выведет токен доступа в консоль. 

    gcloud auth application-default print-access-token

Чтобы узнать больше об аутентификации и учетных данных для вашего приложения, см. разделы «Методы аутентификации в Google» и «Как работают учетные данные приложения по умолчанию» .

Настройка доступа к учетной записи

Предоставьте доступ к Destination электронной почты, связанной с вашей учетной записью пользователя.

  • Если вы используете аккаунт Google Ads, следуйте инструкциям , чтобы добавить адрес электронной почты пользователя в аккаунт Google Ads или в родительский аккаунт Google Ads Manager.
  • Если вы используете учетную запись Display & Video 360, следуйте инструкциям , чтобы добавить адрес электронной почты пользователя в эту учетную запись.
  • Если вы используете сервис Google Analytics, следуйте инструкциям , чтобы добавить адрес электронной почты пользователя в учетную запись.

Следующие шаги

Установите клиентскую библиотеку и запустите примеры кода, чтобы выполнить свой первый запрос к API Data Manager.

Далее
Установить клиентскую библиотеку