Авторизация запросов

Когда ваше приложение запрашивает личные данные, запрос должен быть авторизован аутентифицированным пользователем, имеющим доступ к этим данным.

Каждый запрос, отправляемый вашим приложением в Bid Manager API, должен включать токен авторизации. Токен также идентифицирует ваше приложение для Google.

О протоколах авторизации

Ваше приложение должно использовать OAuth 2.0 для авторизации запросов. Никакие другие протоколы авторизации не поддерживаются. Если ваше приложение использует Google Sign-In , некоторые аспекты авторизации выполняются за вас.

Авторизация запросов с помощью OAuth 2.0

Все запросы к Bid Manager API должны быть авторизованы авторизованным пользователем.

Детали процесса авторизации или «потока» для OAuth 2.0 несколько различаются в зависимости от того, какое приложение вы пишете. Следующий общий процесс применяется ко всем типам приложений:

  1. Когда вы создаете свое приложение, вы регистрируете его с помощью Google API Console . Затем Google предоставляет информацию, которая понадобится вам позже, например идентификатор клиента и секрет клиента.
  2. Отправьте запрос проверки OAuth для своего приложения, чтобы получить доступ к области Bid Manager API.
  3. Активируйте Bid Manager API в Google API Console. (Если API не указан в консоли API, пропустите этот шаг.)
  4. Когда вашему приложению требуется доступ к пользовательским данным, оно запрашивает у Google определенную область доступа.
  5. Google отображает пользователю экран согласия , предлагая ему авторизовать ваше приложение для доступа к некоторым из его данных.
  6. Если пользователь одобряет, Google предоставляет вашему приложению краткосрочный токен доступа .
  7. Ваше приложение запрашивает данные пользователя, прикрепляя токен доступа к запросу.
  8. Если Google определяет, что ваш запрос и токен действительны, он возвращает запрошенные данные.

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

Область действия OAuth

Вот информация об области применения OAuth 2.0 для Bid Manager API:

Сфера Значение
https://www.googleapis.com/auth/doubleclickbidmanager Доступ для чтения/записи.

Чтобы запросить доступ с помощью OAuth 2.0, вашему приложению требуется информация о области, а также информация, которую Google предоставляет при регистрации вашего приложения (например, идентификатор клиента и секрет клиента).