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

Подключение к API продавца Display & Video 360

Для подключения к API Display & Video 360 Seller необходимо выполнить несколько ключевых шагов. API DV360 Seller — это API Google Cloud на основе списков разрешенных пользователей, использующий OAuth 2.0 для аутентификации и авторизации.

Процессом активации занимается команда Display & Video 360 Seller API.

Примечание: Если ваше приложение обращается к API продавца DV360, оно должно пройти проверку OAuth . Если при тестировании приложения на экране отображается сообщение «Непроверенное приложение» , необходимо отправить запрос на проверку, чтобы удалить его. Узнайте больше о непроверенных приложениях или получите ответы на часто задаваемые вопросы о проверке приложений .

Этапы адаптации:

1. Зарегистрируйте учетную запись Google, перейдя по ссылке https://console.cloud.google.com/ .
   • Эта учетная запись будет использоваться для управления токенами доступа для вашего рабочего клиента. Не используйте личную учетную запись Gmail.
   • Данная учетная запись не может быть группой Google.
   • Если вы используете существующий проект Google Cloud: учетная запись должна быть администратором проекта.
2. Обратитесь к команде Google DV360, предоставив данные своей учетной записи, чтобы добавить ее в список разрешенных.
3. Дождитесь подтверждения активации вашей учетной записи.
4. Необязательно и не блокирует выполнение: отправьте запрос на проверку подлинности OAuth для вашего приложения, чтобы получить доступ к области действия https://www.googleapis.com/auth/doubleclickbidmanager .
5. В консоли Google Cloud перейдите в раздел API и сервисы > Библиотека > Частные . Вы должны увидеть API продавца DV360, доступный для вашего проекта.
6. Включите API продавца DV360 .
7. Перейдите в раздел API и сервисы > Учетные данные > Создать учетные данные > Ключ учетной записи службы . Следуйте инструкциям по настройке, приведенным в документации по учетной записи службы OAuth 2.0 .

   Настройте служебный аккаунт:

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

   Аутентификация и авторизация API Google Cloud (обычно объединяемые под общим названием «аутентификация») обычно выполняются с помощью учетной записи службы. Учетная запись службы позволяет вашему коду отправлять учетные данные приложения непосредственно в API Cloud. Учетная запись службы, как и учетная запись пользователя, представлена ​​адресом электронной почты. Однако, в отличие от учетной записи пользователя, учетная запись службы принадлежит только приложению и может использоваться только для доступа к тому API, для которого она была создана. В качестве примера в этом руководстве показано, как создать учетные данные учетной записи службы с помощью консоли Google Cloud.

   Использование консоли Google Cloud

   В консоли Google Cloud в разделе API Manager → Credentials выберите "Create credentials → Service account key".

   

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

   

   Введите «Имя» для этой учетной записи службы. Это имя будет использоваться в качестве имени по умолчанию для вашего «Идентификатора учетной записи службы» (слева от символа «@» в сгенерированном адресе идентификатора учетной записи службы), но вы можете изменить это имя идентификатора учетной записи службы, если хотите. Эти имена могут быть произвольными; важно лишь запомнить их. В поле «Тип ключа» мы рекомендуем оставить значение «JSON». Нажмите «Создать», и консоль Google Cloud сгенерирует ключ 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>[e-mail]",
     "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"
   }

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

8. Свяжитесь с командой DV360, предоставив информацию о созданной вами учетной записи службы (в частности, адрес электронной почты учетной записи службы). Это второй шаг для добавления учетной записи в список разрешенных для авторизации.
9. После авторизации вашей учетной записи службы для вызова API вы можете обратиться к документации DV360 Seller API . Чтобы получить токен аутентификации вручную, см. инструкции в репозитории инструмента oauth2l (используя загруженный вами ключ учетной записи службы в формате JSON). Подробные инструкции по программному получению токенов OAuth доступны в документации Google Cloud Authentication .

Важно: область действия OAuth должна быть https://www.googleapis.com/auth/doubleclickbidmanager