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

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

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

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

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

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

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

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

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

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

• Условия предоставления услуг: Программно получить и принять Условия предоставления услуг, используя ресурсы TermsOfService и TermsOfServiceAgreementState .
• Создание учетных записей : Метод accounts.createAndConfigure теперь поддерживает создание учетных записей с установлением связей (например, accountManagement ), установку alias и отключение проверки электронной почты с помощью поля user.verificationMailSettings.verificationMailMode в пользу проверки на основе API с использованием нового метода accounts.verifySelf .
• Доступ к учетным записям по псевдонимам: Доступ к учетным записям с использованием формата providerId~accountAlias , обеспечивающий согласованный способ для компаний, управляющих несколькими учетными записями, использовать собственные идентификаторы учетных записей.

Запросы

В этой таблице представлено сводное сравнение URL-адресов запросов для распространенных задач управления учетными записями между Content API для покупок и 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 для покупок.

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

Описание запроса	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 для покупок.

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

Описание запроса	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 для покупок управление связями осуществлялось с помощью accounts.link . Merchant API вводит более явную модель с ресурсами 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 для покупок недоступен в Merchant API. Предоставление информации о налоге с продаж в США больше не требуется; для получения дополнительной информации см. обновление спецификации данных продукта Merchant Center 2025 .

Управление корпоративной идентичностью

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

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

Описание запроса	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 (boolean)	black_owned.identity_declaration (enum)	Логическое значение заменяется перечислением ( SELF_IDENTIFIES_AS , DOES_NOT_SELF_IDENTIFY_AS ) для более явного объявления. Это относится ко всем атрибутам идентификации.
include_for_promotions (логическое значение)	promotions_consent (enum)	Глобальное логическое значение заменяется более подробным перечислением ( PROMOTIONS_CONSENT_GIVEN , PROMOTIONS_CONSENT_DENIED ).

Список учетных записей

В Content API для покупок единственным типом расширенной учетной записи была «Многоклиентская учетная запись (MCA)», и для ее отображения был доступен метод accounts.list . Расширенные учетные записи в Merchant API гораздо мощнее, позволяя использовать более широкий спектр типов учетных записей и связей. Для упрощения миграции расширенных учетных записей Merchant API предоставляет прямой эквивалент метода accounts.list из Content API для покупок в виде метода 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	Максимальное количество возвращаемых аккаунтов.