Чтобы обеспечить безопасность данных, контроль доступа и целостность системы, все запросы к Merchant API должны проходить аутентификацию. API использует аутентифицированную идентификационную информацию, чтобы определить, какие действия разрешено выполнять вызывающей стороне. Например, у некоторых вызывающих абонентов может быть доступ только для чтения к данным о товарах, в то время как другие могут изменять настройки аккаунта в Merchant Center.
Это одна из статей о начале работы с Merchant API. Если вы уже настроили аутентификацию для Merchant API, перейдите к следующему разделу: Зарегистрируйтесь в качестве разработчика .
Как авторизовать запросы к Merchant API
Каждый запрос, отправляемый в Merchant API, должен содержать токен авторизации, который идентифицирует ваше приложение в Google. Чтобы настроить аутентификацию и авторизацию, выберите вариант использования, который лучше всего описывает, как вы планируете работать с Merchant API:
Вы создаете приложение для других компаний?
Если да, то вы используете авторизацию OAuth 2.0. Выберите авторизацию OAuth 2.0, если:
- Вы сторонний поставщик или агентство. Вы создаете приложение, например платформу SaaS, которое другие компании будут использовать для управления своими данными в Merchant Center.
- Вам нужно управлять несколькими внешними аккаунтами. Вы хотите, чтобы одно приложение работало с несколькими независимыми аккаунтами Merchant Center, принадлежащими разным владельцам аккаунтов. Для этого им нужно войти в свои аккаунты Google и нажать "Разрешить" в окне запроса доступа.
Вы создаете приложение для своей компании?
Если да, то для доступа к Merchant API вы используете авторизацию сервисного аккаунта. Выберите авторизацию сервисного аккаунта, если:
- Вы создаете собственное приложение. Вы разрабатываете инструмент, который будет использоваться только в вашей компании для управления данными Merchant Center, или хотите, чтобы учетные данные принадлежали приложению, а не отдельному пользователю.
- Вам нужна автоматизация без входа пользователя. Ваше приложение выполняет фоновые задачи, например автоматическое обновление инвентаря или задания cron.
Авторизация OAuth 2.0
Если вы сторонний поставщик или агентство, управляющее несколькими клиентскими аккаунтами, ваше приложение должно использовать OAuth 2.0 для авторизации запросов. Чтобы настроить OAuth 2.0 для Merchant API, выполните следующие действия:
- Создайте учетные данные OAuth 2.0 в разделе API и сервисы в консоли Google Cloud.
- Скачайте учетные данные клиента OAuth2 в файл, например
client-secrets.json - Добавьте адрес электронной почты в качестве пользователя в Merchant Center. Убедитесь, что аккаунт Google, который вы используете для авторизации запросов, добавлен в качестве пользователя в Merchant Center. Подробнее о том, как добавить или удалить пользователя в Merchant Center…
- Назначьте ему роль
Admin, чтобы выполнить регистрацию. Подробнее о ролях и уровнях доступа в Merchant Center… - Настройте аутентификацию с помощью примеров кода. Следуйте инструкциям из официальных примеров кода в разделе Setting up Authentication and Sample Configuration (Настройка аутентификации и пример конфигурации).
Подробнее об авторизации OAuth 2.0 рассказывается в статьях Как разрешить стороннему приложению доступ к аккаунту Merchant Center и Использование OAuth 2.0 для доступа к API Google.
Авторизация сервисного аккаунта
Чтобы разрешить Merchant API доступ к вашему аккаунту Merchant Center, используйте сервисный аккаунт. Чтобы настроить авторизацию сервисного аккаунта для Merchant API, выполните следующие действия:
- Создайте учетные данные сервисного аккаунта в разделе API и сервисы в консоли Google Cloud.
- Скачайте закрытый ключ. Создайте и скачайте закрытый ключ в формате JSON для сервисного аккаунта. Переименуйте файл в
service-account.json. - Добавьте сервисный аккаунт в Merchant Center. Скопируйте уникальный адрес электронной почты сервисного аккаунта, например
sa@project.iam.gserviceaccount.com, и добавьте его в качестве нового пользователя в Merchant Center. Подробнее о том, как добавить или удалить пользователя в Merchant Center… - Назначьте ему доступ
Admin. Подробнее об уровнях доступа в Merchant Center… - Настройте аутентификацию с помощью примеров кода. Следуйте инструкциям из официальных примеров кода в разделе Setting up Authentication and Sample Configuration (Настройка аутентификации и пример конфигурации).
Подробнее об авторизации сервисного аккаунта рассказывается в статьях Как предоставить доступ к аккаунту Merchant Center и Общие сведения о сервисных аккаунтах.