В этом руководстве рассказывается, как использовать OAuth 2.0, чтобы запрашивать доступ к аккаунтам Merchant Center других сторон. Если вы сторонний поставщик, используйте этот рабочий процесс, чтобы ваше приложение могло запрашивать доступ к аккаунтам Merchant Center ваших клиентов.
Если вы разрабатываете внутреннее приложение, которому нужен доступ только к вашему аккаунту Merchant Center, прочитайте статью Как получить доступ к аккаунту.
Как запросить проверку приложения
Приложения, которые обращаются к Merchant API, должны пройти проверку OAuth. Для непроверенных приложений будут показываться предупреждения, а их функциональность будет ограничена.
Приложением считается любой объект с уникальным идентификатором клиента OAuth 2.0 в Google Cloud.
Проверка обычно занимает 3–5 рабочих дней. Чтобы узнать больше и отправить запрос на проверку, ознакомьтесь с требованиями к проверке приложений.
Это правило распространяется на все приложения. Рекомендуем как можно скорее пройти проверку для всех приложений, чтобы избежать перебоев в работе.
Получение областей действия OAuth
Чтобы избежать проблем с выбором области действия, настройте добавочную авторизацию.
Если вы запрашиваете несколько областей действия OAuth, то в окне запроса доступа для вашего приложения по умолчанию не будет выбрана ни одна из них. Когда в приложении появляется окно запроса доступа, пользователь должен вручную выбрать каждую область, чтобы разрешить доступ.
Чтобы использовать Merchant API, ваше приложение должно запросить следующую область действия в окне запроса доступа OAuth:
https://www.googleapis.com/auth/content
Проверьте ответ на запрос OAuth, чтобы убедиться, что ваше приложение получило эту область действия.
Подробнее о правилах OAuth 2.0…
Авторизация запросов
Все запросы, отправляемые приложением в Merchant API, должны содержать токен авторизации. который одновременно является идентификатором этого приложения для Google.
Протоколы авторизации
Для авторизации запросов ваше приложение должно использовать протокол OAuth 2.0. Другие протоколы авторизации не поддерживаются. Если в вашем приложении используется вход с аккаунтом Google, некоторые действия в рамках авторизации выполняются автоматически.
Авторизация запросов с помощью протокола OAuth 2.0
Для всех запросов к Merchant API требуется авторизация от пользователя, прошедшего аутентификацию.
Особенности процесса авторизации с помощью OAuth 2.0 зависят от типа приложения. В общих чертах процедура выглядит так:
- Сначала приложение нужно зарегистрировать через Google API Console. В результате вы получите информацию, которая понадобится вам позже, например идентификатор клиента и секретный код клиента.
- Вы активируете Merchant API в Google API Console. Если такого API в консоли нет, пропустите этот шаг.
- Если приложению требуются пользовательские данные, оно запрашивает у Google нужную область доступа.
- Google показывает пользователю окно запроса доступа с предложением авторизовать приложение для запроса этих данных.
- Если пользователь соглашается, Google предоставляет приложению токен доступа с коротким сроком действия.
- Ваше приложение запрашивает пользовательские данные, указывая токен доступа.
- Получив действительный запрос и токен, Google отправляет необходимые данные.
Иногда процесс может включать дополнительные этапы, например использование токенов обновления для получения новых токенов доступа. Подробную информацию о процедуре для приложений различных типов можно найти в документации по OAuth 2.0.
Информация об области действия OAuth 2.0 для Merchant API:
| Область действия | Значение |
|---|---|
https://www.googleapis.com/auth/content |
Доступ для чтения и записи. |
Чтобы запросить доступ по протоколу OAuth 2.0, приложению нужна информация об области доступа, а также данные, которые Google предоставляет при регистрации приложения (например, идентификатор клиента или секретный код клиента).
Вот пример, который можно использовать для авторизации.