Перенести управление аккаунтом

API учетных записей разделен на набор ресурсов, позволяющих более эффективно управлять вашими учетными записями Merchant Center с более точным контролем над различными аспектами вашей учетной записи.

В этом руководстве объясняются основные изменения и объясняется, как перенести существующую интеграцию управления учетной записью с Content API for Shopping на Merchant API.

От одного ресурса ко многим

В Content API for Shopping ресурс Account представлял собой монолитный объект, содержащий все: от имени учетной записи и URL-адреса веб-сайта до списков пользователей и бизнес-информации.

API продавца разделяет его на несколько более мелких, более специализированных ресурсов. Это изменение обеспечивает более точные и эффективные вызовы API. Например, чтобы обновить только адрес вашей компании, теперь нужно выполнить PATCH запрос к ресурсу BusinessInfo вместо обновления всего объекта Account .

Ниже приведено краткое описание того, как концепции из ресурса Content API для Account покупок сопоставляются с новыми ресурсами в Merchant API:

• Основные данные учетной записи (идентификатор, имя, настройки контента для взрослых) остаются в ресурсе Account .
• Информация о компании (адрес, номер телефона, служба поддержки клиентов) теперь управляется ресурсом BusinessInfo .
• URL-адрес веб-сайта и заявки обрабатываются ресурсом Homepage .
• Управление пользователями осуществляется ресурсом User .
• Отношения между учетными записями (ссылки на расширенные учетные записи, сторонних поставщиков и другие службы Google) управляются ресурсами AccountRelationship и AccountService .
• Атрибуты идентичности компании (например, «владелец — темнокожий», «владелец — женщина») управляются ресурсом BusinessIdentity .
• Соглашения об условиях обслуживания (ToS) — новая функция, которая управляется ресурсами TermsOfService и TermsOfServiceAgreementState .

Новые возможности

API торговца также представляет новые возможности управления аккаунтами, которые были недоступны в API контента для покупок:

• Условия обслуживания: программно извлекайте и принимайте Условия обслуживания с помощью ресурсов TermsOfService и TermsOfServiceAgreementState .
• Доступ к учетной записи по псевдониму: доступ к учетным записям с использованием формата providerId~accountAlias , предоставляя компаниям, управляющим несколькими учетными записями, единообразный способ использования собственных идентификаторов учетных записей.

Запросы

В этой таблице представлено обобщенное сравнение URL-адресов запросов для общих задач управления учетными записями между Content API for Shopping и Merchant API.

Запросить описание	API контента для покупок	API торговца
Получить аккаунт	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}	GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Получить аккаунт по псевдониму	Недоступно напрямую	GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
Список субсчетов	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts	GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
Создать субсчет	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts	POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
Обновить данные учетной записи	PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}	PATCH соответствующий ресурс. Например, чтобы обновить имя аккаунта: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Удалить субсчет	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}	DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Сайт заявки	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite	POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
Связать аккаунты	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link	POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

Управление основной информацией учетной записи

Ресурс Account в Merchant API содержит основные данные учетной записи Merchant Center, такие как ее имя, идентификатор и основные настройки.

Запросить сравнение

Запросить описание	API контента для покупок	API торговца
Получить данные счета	GET /content/v2.1/{merchantId}/accounts/{accountId} (доступ к основным атрибутам, таким как name , adult_content )	GET /accounts/v1/accounts/{account}
Создать дополнительную учетную запись	POST /content/v2.1/{merchantId}/accounts	POST /accounts/v1/accounts:createAndConfigure
Обновить данные учетной записи	PUT /content/v2.1/{merchantId}/accounts/{accountId} (обновление основных атрибутов)	PATCH /accounts/v1/accounts/{account}
Удалить субсчет	DELETE /content/v2.1/{merchantId}/accounts/{accountId}	DELETE /accounts/v1/accounts/{account}

Детальное сравнение полей

API контента для покупок ( Account )	API торговца ( Account )	Примечания
id	account_id	Числовой идентификатор теперь доступен только для вывода. Основным идентификатором является name ресурса.
name	account_name	Человекочитаемое имя учетной записи.
language	language_code	Имя поля теперь — language_code .

Управление бизнес-информацией

Используйте ресурс BusinessInfo для управления общедоступной информацией о вашей компании, такой как адрес и контактная информация службы поддержки клиентов. Он заменяет объект businessInformation в Content API for Shopping.

Запросить сравнение

Запросить описание	API контента для покупок	API торговца
Получить бизнес-информацию	GET /content/v2.1/{merchantId}/accounts/{accountId} (доступ к атрибуту business_information )	GET /accounts/v1/accounts/{account}/businessInfo
Обновление бизнес-информации	PUT /content/v2.1/{merchantId}/accounts/{accountId} (обновление атрибута business_information )	PATCH /accounts/v1/accounts/{account}/businessInfo

Детальное сравнение полей

API контента для покупок ( business_information )	API торговца ( BusinessInfo )	Примечания
phone_number	phone	Теперь это поле phone и используется google.type.PhoneNumber .
customer_service.url	customer_service.uri	Имя поля теперь uri .

Управляйте своей домашней страницей

Для управления URL-адресом сайта вашего магазина, а также для проверки и подачи заявок используйте ресурс Homepage . Он заменяет поле websiteUrl и метод accounts.claimwebsite из Content API for Shopping.

Запросить сравнение

Запросить описание	API контента для покупок	API торговца
Получить URL домашней страницы	GET /content/v2.1/{merchantId}/accounts/{accountId} (получение доступа к атрибуту website_url )	GET /accounts/v1/accounts/{account}/homepage
Обновить URL домашней страницы	PUT /content/v2.1/{merchantId}/accounts/{accountId} (обновление атрибута website_url )	PATCH /accounts/v1/accounts/{account}/homepage
Претендовать на домашнюю страницу	POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite	POST /accounts/v1/accounts/{account}/homepage:claim
Отменить права на домашнюю страницу	Нет в наличии	POST /accounts/v1/accounts/{account}/homepage:unclaim

Детальное сравнение полей

API контента для покупок ( Account )	API торговца ( Homepage )	Примечания
website_url	uri	URL домашней страницы магазина.
Недоступно напрямую	claimed	Булевое поле, которое принимает значение true , если домашняя страница заявлена.

Управление пользователями

Ресурс User позволяет управлять доступом к аккаунту Merchant Center. Он заменяет массив users в ресурсе Account . Ключевое отличие заключается в процессе создания пользователя. В Merchant API добавление пользователя сопровождается отправкой приглашения. Пользователь должен принять приглашение, чтобы получить доступ к аккаунту.

Запросить сравнение

Запросить описание	API контента для покупок	API торговца
Список пользователей	GET /content/v2.1/{merchantId}/accounts/{accountId} (доступ к атрибуту users )	GET /accounts/v1/accounts/{account}/users
Создать пользователя	PUT /content/v2.1/{merchantId}/accounts/{accountId} (обновление атрибута users )	POST /accounts/v1/accounts/{account}/users
Обновить пользователя	PUT /content/v2.1/{merchantId}/accounts/{accountId} (обновление атрибута users )	PATCH /accounts/v1/accounts/{account}/users/{email}
Удалить пользователя	PUT /content/v2.1/{merchantId}/accounts/{accountId} (обновление атрибута users )	DELETE /accounts/v1/accounts/{account}/users/{email}

Детальное сравнение полей

API контента для покупок (объект массива users )	API торговца (ресурс User )	Примечания
email_address	name (в формате accounts/{account}/users/{email} )	Адрес электронной почты пользователя теперь является частью названия ресурса.
admin , order_manager , reporting_manager и т. д.	access_rights	Права доступа теперь объединены в повторяющееся поле перечисления.
Нет в наличии	state	Новое поле, предназначенное только для вывода, указывающее, находится ли пользователь в PENDING или VERIFIED .

Управление отношениями с клиентами и услугами

В Content API for Shopping управление отношениями осуществлялось с помощью accounts.link . API Merchant представляет более явную модель с ресурсами AccountService и AccountRelationship , требующую процесса согласования (предложения и принятия).

Запросить сравнение

Запросить описание	API контента для покупок	API торговца
Связать аккаунты	POST /content/v2.1/{merchantId}/accounts/{accountId}/link	POST /accounts/v1/accounts/{account}/services:propose
Список связанных аккаунтов	GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks	GET /accounts/v1/accounts/{account}/relationships и GET /accounts/v1/accounts/{account}/services

Детальное сравнение полей

API контента для покупок ( AccountLink )	API торговца ( AccountService , AccountRelationship )	Примечания
linked_account_id	provider (в AccountService )	Идентификатор учетной записи, предоставляющей услугу.
service	service_type (в AccountService )	Тип предоставляемой услуги (например, ACCOUNT_AGGREGATION ).
status	handshake.approval_state (в AccountService )	Статус ссылки (например, PENDING , ESTABLISHED ).

Настройки налога на счет

Сервис accounttax из Content API for Shopping недоступен в Merchant API. Он больше не требуется для предоставления налога с продаж в США. Подробнее см. в обновлении спецификации данных о продуктах Merchant Center 2025 года .

Управление идентификацией компании

Используйте ресурс BusinessIdentity для самостоятельного объявления атрибутов вашей компании. Он заменяет объект businessIdentity в Content API for Shopping.

Запросить сравнение

Запросить описание	API контента для покупок	API торговца
Получите фирменный стиль	GET /content/v2.1/{merchantId}/accounts/{accountId} (доступ к атрибуту business_identity )	GET /accounts/v1/accounts/{account}/businessIdentity
Обновление фирменного стиля	PUT /content/v2.1/{merchantId}/accounts/{accountId} (обновление атрибута business_identity )	PATCH /accounts/v1/accounts/{account}/businessIdentity

Детальное сравнение полей

API контента для покупок ( business_identity )	API торговца ( BusinessIdentity )	Примечания
black_owned.self_identified (логическое значение)	black_owned.identity_declaration (перечисление)	Булевое значение заменяется перечислением ( SELF_IDENTIFIES_AS , DOES_NOT_SELF_IDENTIFY_AS ) для более явного объявления. Это относится ко всем атрибутам идентификации.
include_for_promotions (логическое значение)	promotions_consent (перечисление)	Глобальное логическое значение заменяется более описательным перечислением ( PROMOTIONS_CONSENT_GIVEN , PROMOTIONS_CONSENT_DENIED ).

Список счетов

В Content API for Shopping единственным типом расширенных аккаунтов был «Мультиклиентский аккаунт (MCA)», и для него был доступен метод accounts.list для отображения списка дочерних аккаунтов данного мультиклиентского аккаунта. Расширенные аккаунты в Merchant API гораздо мощнее, позволяя использовать более широкий спектр типов аккаунтов и их взаимосвязей. Для упрощения миграции расширенных аккаунтов Merchant API предоставляет прямой эквивалент метода accounts.list из Content API for Shopping в виде метода accounts.listSubaccounts . Мы представляем новый, более мощный метод accounts.list , который позволяет осуществлять расширенную фильтрацию аккаунтов.

Запросить сравнение

Запросить описание	API контента для покупок	API торговца
Список субсчетов	GET /content/v2.1/{merchantId}/accounts	GET /accounts/v1/accounts/{providerId}:listSubaccounts
Список всех доступных учетных записей	Нет в наличии	GET /accounts/v1/accounts

Подробное сравнение полей (параметры запроса)

API контента для покупок ( accounts.list )	API торговца ( accounts.listSubaccounts )	Примечания
merchant_id (параметр пути)	provider (параметр пути)	Идентификатор расширенной учетной записи в формате accounts/{account} .
max_results	page_size	Максимальное количество возвращаемых аккаунтов.