Вы можете использовать API учетных записей для управления связями между вашей учетной записью Merchant Center и другими поставщиками услуг. Связь — это формальная взаимосвязь, позволяющая поставщику предлагать вашей компании определенные услуги. Услуга определяет разрешения и возможности, предоставляемые поставщику, такие как управление продуктами или управление кампаниями. Например, привязка вашей учетной записи Merchant Center к учетной записи Google Ads позволяет учетной записи Ads использовать данные о ваших продуктах для запуска рекламных кампаний.
Взаимосвязь состоит из следующих атрибутов:
- Учетная запись в Торговом центре, получающая услугу.
- Поставщик услуг
- Услуга или набор услуг, предоставляемых учетной записи Merchant Center.
Псевдоним
Поставщики услуг могут связывать псевдоним с обслуживаемыми ими учетными записями (это эквивалент поля seller_id , которое присутствовало в ресурсе учетной записи в Content API для покупок). Псевдоним может быть назначен с помощью необязательного поля account_id_alias в ресурсе AccountRelationship и служит пользовательским идентификатором. Псевдоним должен состоять из 1–50 символов, выбранных из символов ASCII, десятичных знаков, дефисов, подчеркиваний, точек или тильд ( [A-Za-z0-9_~.-]{1,50} ).
Структура URL-адреса для доступа к учетной записи с использованием ее псевдонима выглядит следующим образом: GET /accounts/v1/accounts/{provider}~{account_id_alias} .
Услуги
В API учетных записей учетные записи могут получать следующие услуги. Многие из этих услуг можно добавить при создании учетной записи .
Агрегация учетных записей : Эта услуга связывает расширенную учетную запись с другой учетной записью, предоставляя расширенной учетной записи полный, неограниченный доступ. Обычно она используется маркетплейсами, розничными продавцами, работающими с несколькими брендами, или международными розничными компаниями, которым необходим централизованный контроль над вложенными учетными записями. Если вы являетесь платформой электронной коммерции или партнером по каналам продаж, мы рекомендуем использовать вместо этого
accountManagement. При создании учетной записи с использованием агрегации учетных записей параметрexternalAccountIdнеобходимо опустить.Управление кампаниями : Эта услуга моделирует связь между аккаунтом Merchant Center и аккаунтом Google Ads, предоставляя аккаунту Ads доступ к данным о товарах и аккаунте, необходимым для запуска рекламных кампаний. В данном случае поставщиком услуг является
GOOGLE_ADS, аexternalAccountId— это идентификатор аккаунта Google Ads. Эту услугу также можно предложить существующему аккаунту.
Сравнение цен : Это означает взаимодействие со службой сравнения цен (Comparison Shopping Service, CSS), которая управляет учетной записью в Merchant Center.
Управление локальными объявлениями : это взаимодействие с управляющим магазином для управления локальными запасами и объявлениями с использованием профиля Google Business.
Управление учетной записью : Эта услуга позволяет поставщику выполнять административные действия с учетной записью Merchant Center, такие как настройка параметров учетной записи, управление пользователями или обновление информации о компании. Компания также может ограничить предоставленный доступ. При использовании во время создания учетной записи эта услуга создает учетную запись, связанную с поставщиком, что является рекомендуемым подходом для платформ электронной коммерции и партнеров по каналам продаж. Ее также можно предложить для существующей учетной записи.
Управление продуктами : Эта услуга позволяет поставщикам управлять продуктами и связанными с ними функциями, такими как источники данных и правила. При добавлении во время создания учетной записи она обычно используется в сочетании с
accountManagementилиaccountAggregation. Эту услугу также можно предложить существующей учетной записи.
Рукопожатие
Для установления соединения необходимо авторизовать связь как с учетной записью, предоставляющей услугу, так и с учетной записью, получающей услугу. Этот процесс авторизации называется рукопожатием.
Рукопожатие — это двухэтапный процесс:
- Одна из сторон предлагает создать сервисную связь.
- Другая сторона одобряет или отклоняет предложение.
После принятия предложения услуга утверждается и считается полностью запущенной. Все права доступа, предоставленные поставщику услуг, теперь передаются квалифицированным пользователям (см. права доступа ниже).
Обратите внимание, что пользователь, создающий, отклоняющий или утверждающий предложение, должен иметь права ADMIN в учетной записи, инициирующей процесс. Таким образом, если поставщик услуг предлагает услугу, пользователь, создающий предложение, должен иметь ADMIN в учетной записи поставщика услуг, а пользователь, принимающий или отклоняющий предложение, должен иметь ADMIN в учетной записи получателя.
Особенности рукопожатия, специфичные для конкретной услуги
Ниже приведено описание конкретных требований к рукопожатию для каждой отдельной услуги:
Агрегация учетных записей : Эта услуга может быть настроена только в рамках создания учетной записи. Предполагается, что поставщик услуг имеет расширенный доступ к учетной записи, и услуга автоматически утверждается, поскольку пользователи расширенного доступа имеют полный
ADMINдоступ к создаваемой учетной записи.Сравнение цен : Эта услуга автоматически одобряется при добавлении во время создания учетной записи с помощью
createAndConfigure.Управление кампаниями : Хотя это и происходит в соответствии со стандартным процессом согласования, предложения вносятся в одной системе (например, Google Ads), а утверждения осуществляются в другой системе (например, в Merchant Center или через Merchant API).
Управление локальными объявлениями : для этой услуги предлагается использовать специальный метод установления связи, а подтверждения осуществляются в другой системе (например, в профиле Google Business). Подробные шаги описаны в руководстве по привязке профиля Google Business .
Управление учетной записью : Для этой услуги при использовании функции
proposeприменяется стандартный процесс подтверждения связи. Если услуга добавляется при создании учетной записи с помощьюcreateAndConfigure, она автоматически утверждается.Управление продуктами : Для данной услуги применяется стандартная процедура согласования (предложение от одной стороны, затем одобрение от другой).
Права доступа
Каждый тип услуги предоставляет пользователям поставщика услуг определенный уровень доступа к обслуживаемой учетной записи:
Агрегация учетных записей : Эта услуга предоставляет полные права
ADMIN.Управление рекламными кампаниями : Эта услуга предоставляет ограниченный доступ, позволяя связанному рекламному аккаунту получать доступ к товарам и основной информации об аккаунте.
Сравнение цен : Этот сервис по умолчанию предоставляет полные права
ADMIN. Однако компания может ограничить доступ, предоставляемый в Merchant Center.Управление локальными объявлениями : Эта услуга не предоставляет прямого доступа. Вместо этого она позволяет синхронизировать товары в объявлении с учетной записью Merchant Center.
Важно : права доступа, описанные для следующих типов услуг, применяются только к утвержденным поставщикам услуг. Обратитесь в нашу службу поддержки , если вы являетесь поставщиком услуг и хотите использовать эту возможность. Если вы уже получили разрешение на использование метода accounts.link для управления товарами в Content API для покупок, вы можете использовать эту услугу в Merchant API без дополнительных разрешений.
Управление учетной записью : Эта услуга по умолчанию предоставляет полные права
ADMIN.Управление продуктами : Эта услуга предоставляет полные права
ADMIN. Обратите внимание, что в будущем доступ будет ограничен только правами, связанными с продуктами.
Как применяются принципы взаимоотношений к сторонним платформам
Если вы являетесь сторонней платформой, управляющей учетными записями от имени других компаний, ниже показано, как различные концепции соотносятся со структурой ваших учетных записей:
- Поставщик услуг : Ваш расширенный аккаунт .
- Учетная запись, получающая услугу : учетная запись в Merchant Center, представляющая бизнес, которым вы управляете.
- Услуга :
-
accountManagement: Это рекомендуемая услуга для платформ электронной коммерции и партнеров по каналам продаж, создающих новые учетные записи от имени продавцов. Она создает учетную запись, принадлежащую продавцу, которая затем связывается с вами для управления. Это соответствует предпочтительной структуре Merchant Center для данного сценария использования. -
accountAggregation: Эта услуга связывает вашу расширенную учетную запись с другой учетной записью. Хотя она поддерживается, ее не рекомендуется использовать на платформах электронной коммерции и у партнеров по каналам продаж.
-
Подробную информацию о настройке расширенного аккаунта и его привязке к новым аккаунтам Merchant Center см. в разделе «Создание аккаунтов» .