Cómo migrar la administración de la cuenta desde Content API for Shopping

Puedes usar el recurso accounts para crear y administrar tu cuenta de comerciante. Para obtener más información, consulta la Descripción general de la API de Merchant Accounts.

En esta página, se describe cómo migrar la administración de cuentas de Content API a la API de Merchant.

Solicitudes

Usa el siguiente formato de URL de solicitud para la API de Merchant Accounts:

POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts

A continuación, puedes ver una comparación de ejemplo de Content API for Shopping con la API de cuentas de comerciante para las solicitudes de creación y administración de cuentas:

	Content API for Shopping	API de cuentas de comerciante
URL	https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/	https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
Identificadores	{merchantId}/accounts/{accountId}	{accountId}

Recursos

Los datos de la cuenta se pasan con el recurso Account en Content API for Shopping. La API de Merchant Accounts proporciona varios recursos para pasar datos de cuentas. Estos recursos incluyen los recursos Account, User, BusinessInfo y BusinessIdentity.

En la siguiente tabla, se proporciona una comparación entre el recurso Account en Content API for Shopping y el recurso Account en la API de Merchant Accounts.

Content API for Shopping	API de cuentas de comerciante
id	account_id
name	account_name
kind	No disponible
websiteUrl	Campo uri en el recurso homepage
adultContent	adult_content
sellerId	No disponible
users	En User recurso
youtubeChannelLinks	Aún no está disponible
googleMyBusinessLink	Aún no está disponible
businessInformation	En businessInfo recurso
businessIdentity	En businessIdentity recurso
automaticImprovements	Aún no está disponible
adsLinks	Aún no está disponible
cssId	Disponible solo en la API de CSS
labelIds	Disponible solo en la API de CSS
accountManagement	Aún no está disponible
automaticLabelIds	Disponible solo en la API de CSS
conversionSettings	Aún no está disponible

En la siguiente tabla, se proporciona una comparación entre el recurso AccountUser en Content API for Shopping y el recurso User en la API de Merchant Accounts.

Content API for Shopping	API de cuentas de comerciante
emailAddress	email es parte de name (accounts/{account}/users/{email}).
admin	user#access_rights.ADMIN
orderManager	No disponible
paymentsManager	No disponible
paymentsAnalyst	No disponible
reportingManager	user#access_rights.PERFORMANCE_REPORTING

En la siguiente tabla, se proporciona una comparación entre el recurso AccountBusinessInformation en Content API for Shopping y su recurso equivalente businessinfo en la API de Merchant Accounts.

Content API for Shopping	API de cuentas de comerciante
businessInformation	businessinfo
phoneNumber	phone
phoneVerificationStatus	phone_verification_state
customerService	customer_service
koreanBusinessRegistrationNumber	No disponible

En la siguiente tabla, se proporciona una comparación entre el recurso AccountBusinessIdentity en Content API for Shopping y el recurso businessIdentity en la API de Merchant Accounts.

Content API for Shopping	API de cuentas de comerciante
blackOwned	black_owned
womenOwned	women_owned
veteranOwned	veteran_owned
latinoOwned	latino_owned
smallBusiness	small_business
includeForPromotions	promotions_consent true significa PROMOTION_CONSENT_GIVEN false significa PROMOTION_CONSENT_DENIED

En la siguiente tabla, se proporciona una comparación entre el recurso AccountIdentityType en Content API for Shopping y el recurso identityAttribute en la API de Merchant Accounts.

Content API for Shopping	API de cuentas de comerciante
self_identified	identity_declaration true significa SELF_IDENTIFIES_AS false significa DOES_NOT_SELF_IDENTIFY_AS

Métodos

Se introdujeron los siguientes métodos en la API de cuentas de comerciante:

Content API for Shopping	API de cuentas de comerciante
accounts.authinfo	GET https://merchantapi.googleapis.com/accounts/v1beta/accounts sin filtro
accounts.claimwebsite	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId/homepage:claim Para obtener más información, consulta Método: accounts.v1beta.accounts.homepage.claim
accounts.custombatch	No disponible. Los lotes personalizados no son compatibles con la API de Merchant Center.
accounts.delete	DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId
accounts.get	Se asigna a una solicitud GET para el recurso en el que se definen el campo obligatorio o el conjunto de campos.
accounts.insert	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure Para obtener más información, consulta Crea y configura una cuenta de comerciante.
accounts.link	Todavía no es compatible.
accounts.list	GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks	Todavía no es compatible.
accounts.update	Se asigna a una solicitud de actualización del recurso en el que se definen el campo obligatorio o el conjunto de campos.