Migrar o gerenciamento da conta da API Content for Shopping

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

Esta página descreve como você pode migrar o gerenciamento da conta da API Content para 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 API 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 método Recurso Account em Conteúdo para o Shopping. A API Merchant Accounts fornece vários recursos para transmitir de contas de serviço. Esses recursos incluem Account, User, BusinessInfo e BusinessIdentity recursos.

A tabela a seguir mostra uma comparação entre as Account na API Content for Shopping e na Account em 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 as O recurso AccountUser na API Content for Shopping e no 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 as AccountBusinessInformation recurso 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 mostra uma comparação entre as AccountBusinessIdentity na API Content para Compras e 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 e
true significa PROMOTION_CONSENT_GIVEN
false significa PROMOTION_CONSENT_DENIED

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

API Content for Shopping API Merchant Accounts
self_identified identity_declaration e
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 e
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.