Migrar o gerenciamento da conta da API Content for Shopping

Você pode usar o recurso accounts para criar e gerenciar sua conta de comerciante. Para mais informações, consulte Visão geral da API Merchant Accounts.

Nesta página, descrevemos como migrar o gerenciamento da conta da API Content para a API Merchant.

Solicitações

Use o seguinte formato de URL de solicitação para a API Merchant Accounts:

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

Este é um exemplo de comparação entre a API Content for Shopping e a API Merchant Accounts para solicitações de criação e gerenciamento de contas:

	API Content for Shopping	API Merchant Accounts
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

Os dados da conta são transmitidos usando o recurso Account na API Content for Shopping. A API Merchant Accounts fornece vários recursos para transmitir dados das contas. Esses recursos incluem Account, User, BusinessInfo e BusinessIdentity.

A tabela a seguir fornece uma comparação entre o recurso Account na API Content for Shopping e o recurso Account na API Merchant Accounts.

API Content for Shopping	API Merchant Accounts
id	account_id
name	account_name
kind	Indisponível
websiteUrl	Campo uri no recurso homepage
adultContent	adult_content
sellerId	Indisponível
users	No recurso User
youtubeChannelLinks	Ainda não disponível
googleMyBusinessLink	Ainda não disponível
businessInformation	No recurso businessInfo
businessIdentity	No recurso businessIdentity
automaticImprovements	Ainda não disponível
adsLinks	Ainda não disponível
cssId	Disponível apenas na API CSS
labelIds	Disponível apenas na API CSS
accountManagement	Ainda não disponível
automaticLabelIds	Disponível apenas na API CSS
conversionSettings	Ainda não disponível

A tabela a seguir mostra uma comparação entre o recurso AccountUser na API Content for Shopping e o recurso User na API Merchant Accounts.

API Content for Shopping	API Merchant Accounts
emailAddress	email faz parte de name (accounts/{account}/users/{email}).
admin	user#access_rights.ADMIN
orderManager	Indisponível
paymentsManager	Indisponível
paymentsAnalyst	Indisponível
reportingManager	user#access_rights.PERFORMANCE_REPORTING

A tabela a seguir mostra uma comparação entre o recurso AccountBusinessInformation na API Content for Shopping e o recurso equivalente businessinfo na API Merchant Accounts.

API Content for Shopping	API Merchant Accounts
businessInformation	businessinfo
phoneNumber	phone
phoneVerificationStatus	phone_verification_state
customerService	customer_service
koreanBusinessRegistrationNumber	Indisponível

A tabela a seguir fornece uma comparação entre o recurso AccountBusinessIdentity na API Content for Shopping e o recurso businessIdentity na API Merchant Accounts.

API Content for Shopping	API Merchant Accounts
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

A tabela a seguir fornece uma comparação entre o recurso AccountIdentityType na API Content for Shopping e o recurso identityAttribute na API Merchant Accounts.

API Content for Shopping	API Merchant Accounts
self_identified	identity_declaration true significa SELF_IDENTIFIES_AS false significa DOES_NOT_SELF_IDENTIFY_AS

Métodos

Os métodos a seguir foram introduzidos na API Merchant Accounts:

API Content for Shopping	API Merchant Accounts
accounts.authinfo	GET https://merchantapi.googleapis.com/accounts/v1beta/accounts sem filtro
accounts.claimwebsite	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId/homepage:claim Para mais informações, consulte Método: accounts.v1beta.accounts.homepage.claim
accounts.custombatch	Indisponível. Lotes personalizados não são compatíveis com a API Merchant.
accounts.delete	DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId
accounts.get	Mapeia para uma solicitação GET do recurso em que o campo obrigatório ou o conjunto de campos está definido.
accounts.insert	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure Para mais informações, consulte Criar e configurar uma conta de comerciante.
accounts.link	Ainda sem suporte
accounts.list	GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks	Ainda sem suporte
accounts.update	Mapeia para uma solicitação de atualização do recurso em que o campo obrigatório ou o conjunto de campos está definido.