Подключение DV360 Exchange Reporting API и настройка OAuth

API отчетов Exchange DV360 представлен как Google Cloud API на основе белого списка, который использует OAuth. Процесс создания белого списка осуществляется командой DV360 Exchange Reporting API.

Процедура

Ниже приведены шаги по подключению к DV360 Exchange Reporting API:

  1. Зарегистрируйте учетную запись Google в консоли Google Cloud .

    Обратите внимание, что эта учетная запись должна использоваться для управления токенами доступа для вашего рабочего клиента, поэтому не используйте свою личную учетную запись Gmail.

  2. Свяжитесь с Google DV360, указав информацию об учетной записи, чтобы добавить ее в белый список.

  3. После того как вы получите уведомление о том, что находитесь в белом списке, запросите проверку OAuth, чтобы предоставить вашему приложению доступ к области действия doubleclickbidmanager .

  4. Войдите в консоль Google Cloud .

    Перейдите в API и службы > Библиотека > Частный . Вы должны увидеть API отчетов Exchange DV360, указанный в списке доступных вам API. Включите API отчетов Exchange DV360.

  5. Перейдите в раздел «Учетные данные» > «Создать учетные данные» > «Ключ учетной записи службы» . Следуйте инструкциям, чтобы создать учетную запись службы .

Сервисный аккаунт

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

Ниже приведены шаги по созданию учетных данных сервисной учетной записи с помощью консоли Google Cloud:

  1. На странице «Диспетчер API» > «Учетные данные» выберите «Создать учетные данные» → «Ключ учетной записи службы» .

  2. Выберите «Новая учетная запись службы» в раскрывающемся списке «Учетная запись службы» .

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

    В разделе «Тип ключа» мы рекомендуем оставить значение JSON . Нажмите «Создать» , чтобы сгенерировать ключ JSON в виде текстового файла .json . При появлении запроса загрузите файл на свой компьютер, и отобразится диалоговое окно создания учетной записи службы .

    Вот пример ключа JSON:

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. Надежно храните файл JSON, поскольку он содержит ваш закрытый ключ, и этот файл является единственной копией этого ключа. Учетные данные в этом файле необходимы, когда ваш код выполняет вызовы API.

  4. Свяжитесь с DV360, указав информацию об учетной записи службы , которую вы создали, в частности, адрес электронной почты учетной записи службы. Это часть процесса создания белого списка для доступа к API.

Токен доступа

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