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

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

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

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, presentamos una comparación de ejemplo de Content API for Shopping con el comercio API de Accounts para 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 mediante el Recurso Account en Contenido para Shopping. La API de Merchant Accounts proporciona varios recursos para pasar datos de las cuentas de servicio. Estos recursos incluyen Account, User, BusinessInfo y BusinessIdentity.

En la siguiente tabla, se muestra una comparación entre los Account en Content API for Shopping y en el Recurso Account en 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 muestra una comparación entre los Recurso AccountUser en Content API for Shopping y en 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 muestra una comparación entre los AccountBusinessInformation recurso de 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 muestra una comparación entre los Recurso AccountBusinessIdentity en Content API para Shopping y businessIdentity recurso 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 de
true significa PROMOTION_CONSENT_GIVEN
false significa PROMOTION_CONSENT_DENIED

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

Content API for Shopping API de cuentas de comerciante
self_identified identity_declaration de
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 de
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.