Для эффективного использования Merchant API важно понимать концепции регистрации, аутентификации и авторизации . Они выполняют разные функции, обеспечивая безопасный и корректный доступ к данным Merchant Center.
Терминология
Регистрация, аутентификация и авторизация взаимосвязаны, но каждая из них имеет своё собственное значение и цель.
- Аутентификация : В этом процессе сервис проверяет личность пользователя или приложения, отправляющего API-запрос. Merchant API использует стандартные механизмы Google, такие как OAuth 2.0 . Для получения дополнительной информации см. разделы «Аутентификация запросов» и «Аутентификация от имени собственной учетной записи» .
- Авторизация : Этот процесс определяет, какие действия разрешено выполнять авторизованному пользователю или приложению с использованием учетной записи Merchant Center. Он отвечает на вопрос: «Что вы можете делать?» на основе ролей и разрешений, предоставленных авторизованному пользователю в учетной записи Merchant Center. Например, пользователю может быть разрешено читать данные о товарах, но не изменять настройки учетной записи.
- Регистрация : Что касается Merchant API, это одноразовая процедура настройки, которая позволяет Google отправлять вам важные уведомления о работе сервиса для управляемых вами торговых учетных записей. Регистрация добавляет ваши адреса электронной почты разработчика к вашей основной учетной записи Merchant Center и связывает их с идентификаторами проектов Google Cloud, которые вы используете для аутентификации. Эта связь позволяет вашему приложению получать уведомления о работе сервиса для всех управляемых вами торговых учетных записей. Для получения дополнительной информации см. раздел «Создание проекта Google Cloud» .
Регистрация
Процесс регистрации имеет решающее значение для того, чтобы ваше приложение могло использовать API для продавцов. Вот что вам нужно знать:
Предварительные требования
Для регистрации в системе Merchant API необходимо следующее:
- Для доступа к учетной записи Merchant Center вам потребуется уже существующая учетная запись Merchant Center.
- Административный доступ: Учетная запись Google, которую вы используете для инициирования запроса на регистрацию, должна обладать правами администратора в учетной записи Merchant Center, которую вы регистрируете.
- Проект Google Cloud : Ваше приложение должно быть связано с проектом Google Cloud. Этот проект предоставляет необходимые учетные данные (например, идентификаторы клиента OAuth 2.0) для аутентификации вашего приложения.
Почему невозможно зарегистрировать общий проект Google Cloud
Такие инструменты, как Google OAuth Playground и API Explorer, используют общие проекты Google Cloud, принадлежащие Google. Вы не можете зарегистрироваться в общих проектах по следующим причинам:
- Они предназначены для тестирования и исследования, а не для определения оптимального варианта для использования в производственной среде.
- Регистрация этих данных подразумевает связь между общим инструментом и вашими конкретными данными в Merchant Center и может привести к нежелательной коммуникации.
Для того чтобы сообщения API для продавцов, отправляемые вам Google, оставались актуальными для вашего фактического использования, вашему приложению необходим собственный выделенный проект в Google Cloud.
Тем не менее, вы можете использовать веб-приложения OAuth Playground и API Explorer для экспериментов и непроизводственных задач с использованием Merchant API.
Найдите идентификатор своего проекта Google Cloud.
Идентификатор и номер проекта можно найти в консоли Google Cloud. Подробнее см. раздел «Как найти название, номер и идентификатор проекта ».
Сделайте звонок для регистрации.
Зарегистрируйтесь, используя метод registerGcp в под-API « Accounts . Этот вызов связывает номер вашего проекта Google Cloud с учетной записью Merchant Center.
В процессе вам необходимо указать адрес электронной почты, связанный с конкретным пользователем, который вы используете для вызова API. Этот адрес электронной почты должен принадлежать пользователю с правами администратора в учетной записи Merchant Center.
О поле электронной почты
Эффективная коммуникация — ключ к успеху. Google рассылает важные обновления, обязательные сервисные объявления (MSA), проводит опросы разработчиков и предоставляет другие возможности, связанные с API для продавцов. Правильное управление контактами гарантирует, что эта информация дойдет до нужных людей.
- Назначение : Google использует этот адрес электронной почты в качестве основного контактного лица для связи по вопросам, связанным с API.
- Чей адрес электронной почты : Это должен быть адрес электронной почты отдельного разработчика или ключевого технического контактного лица, ответственного за интеграцию API.
- Передовые методы :
- РЕКОМЕНДУЕТСЯ : Использовать корпоративный адрес электронной почты сотрудника.
- НЕ СЛЕДУЕТ : Использовать общие групповые псевдонимы или адреса электронной почты служебных учетных записей. Мы предполагаем, что общение будет осуществляться с участием людей.
users ресурс для управления контактами
Хотя адрес электронной почты, указанный при регистрации, задает первоначальный контакт, более надежный способ управления контактами и правами — использование ресурса accounts.users в Merchant API или настроек управления пользователями в пользовательском интерфейсе Merchant Center. Дополнительную информацию об использовании Merchant Center см. в разделе « Управление пользователями в вашей учетной записи» .
Воспользуйтесь этими функциями следующим образом:
- Добавить всех разработчиков : Добавьте разработчиков, работающих над интеграцией API, в качестве пользователей учетной записи Merchant Center.
- Назначение роли
API_DEVELOPER: Помимо стандартных ролей ( Администратор , Стандарт ), вы можете назначить пользователям рольAPI_DEVELOPER. В частности, назначьте эту роль пользователям, которые должны получать сообщения, связанные с API. Вы можете комбинировать ее с другими ролями. - Преимущества :
- Четкое разделение : отделяет управление контактами через API от одноразовой регистрации.
- Гибкость : Обновляйте контактную информацию по мере изменения состава команды.
- Целенаправленная коммуникация : Обеспечивает доставку новостей, касающихся API, соответствующим заинтересованным лицам.
Даже если вы указали адрес электронной почты при регистрации, мы настоятельно рекомендуем управлять контактами API, добавляя пользователей с ролью API_DEVELOPER .
Ссылки
Для получения более подробной информации см. следующие материалы: