Чтобы эффективно использовать Merchant API, важно понимать, что такое регистрация, аутентификация и авторизация. Они служат разным целям, обеспечивая безопасный и правильный доступ к данным Merchant Center.
Терминология
Регистрация, аутентификация и авторизация связаны между собой, но у каждой из них есть свое значение и цель.
- Аутентификация. В ходе этого процесса сервис проверяет личность пользователя или приложение, отправляющее запрос к API. Merchant API использует стандартные механизмы Google, такие как OAuth 2.0. Использование ключей API для аутентификации не поддерживается и приводит к ошибкам аутентификации. Дополнительную информацию можно найти в статьях Аутентификация запросов и Аутентификация в собственном аккаунте.
- Авторизация. В ходе этого процесса определяется, какие действия может выполнять аутентифицированный пользователь или приложение в аккаунте Merchant Center. Она отвечает на вопрос "Что вы можете делать?" на основе ролей и разрешений, предоставленных пользователю, прошедшему аутентификацию, в аккаунте Merchant Center. Например, у пользователя может быть разрешение на просмотр данных о товарах, но не на изменение настроек аккаунта.
- Регистрация. В Merchant API это однократная процедура настройки, которая позволяет Google отправлять вам важные служебные уведомления для управляемых вами аккаунтов продавцов. При регистрации адреса электронной почты разработчиков добавляются в основной аккаунт Merchant Center и связываются с идентификаторами проектов Google Cloud, которые используются для аутентификации. Это позволит вашему приложению получать служебные уведомления для всех аккаунтов продавцов, которыми вы управляете. Подробнее о том, как создать проект Google Cloud…
Регистрация
Регистрация – это обязательный этап, без которого вы не сможете использовать Merchant 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 есть связь, и это может привести к нежелательным сообщениям.
Для вашего приложения нужен отдельный проект Google Cloud, чтобы вы получали от Google только те сообщения о Merchant API, которые относятся к вашему использованию.
Тем не менее вы можете использовать веб-приложения OAuth Playground и API Explorer, чтобы экспериментировать с Merchant API и применять его в непроизводственных целях.
Как найти идентификатор проекта Google Cloud
Идентификатор проекта и номер проекта можно найти в консоли Google Cloud. Подробнее о том, как найти название, номер и идентификатор проекта…
Как выполнить регистрационный вызов
Зарегистрируйтесь с помощью метода registerGcp в дочернем API Accounts. Этот вызов связывает номер проекта Google Cloud с аккаунтом Merchant Center.
В процессе вам нужно будет указать адрес электронной почты, связанный с отдельным пользователем, который вы используете для вызова API. Этот адрес должен принадлежать пользователю с правами администратора в аккаунте Merchant Center.
Поле электронной почты
Эффективная коммуникация – это ключ к успеху. Google отправляет важные новости, обязательные уведомления, опросы разработчиков и другие сообщения, связанные с Merchant 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.
Ссылки
Дополнительную информацию можно найти в следующих статьях: