Criar e configurar uma conta do comerciante

Você precisa ter uma conta do Merchant Center para usar a API Merchant. Você pode usar a interface do Merchant Center para criar.

Se você precisar gerenciar várias contas, crie subcontas usando a API Merchant.

É possível configurar sua conta na interface do Merchant Center ou pela API, conforme descrito mais adiante.

Aceitar os Termos de Serviço do Merchant Center

Todos os comerciantes precisam aceitar os Termos de Serviço do Merchant Center. Veja como aceitar os Termos de Serviço da sua conta de comerciante:

1. Ligue para accounts.termsOfServiceAgreementStates.retrieveForApplication para saber quais Termos de Serviço são necessários para sua conta.

   Confira um exemplo de solicitação:

   GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates:retrieveForApplication
   

   Confira um exemplo de resposta de uma chamada bem-sucedida:

   {
       "name": "accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates/MERCHANT_CENTER-{COUNTRY}",
       "regionCode": {COUNTRY},
       "termsOfServiceKind": "MERCHANT_CENTER",
       "accepted": {
         "termsOfService": "termsOfService/{VERSION}",
         "acceptedBy": "accounts/{ACCOUNT_ID}"
       }
   }
   

2. Chame termsOfService.accept para aceitar os Termos de Serviço.

   Confira um exemplo de solicitação:

   GET https://merchantapi.googleapis.com/accounts/v1beta/{name=termsOfService/{VERSION}}:accept
   

   Se bem-sucedido, o corpo da resposta fica vazio.

Atenção: não aceite os Termos de Serviço em nome de outro comerciante. Em vez disso, mostre os Termos de Serviço ao comerciante e peça para ele aceitar.

Recomendamos criar uma interface em que você mostre os TOS ao comerciante e peça para que ele aceite.

1. Encontre os TOS que o comerciante precisa aceitar usando termsOfService.retrieveLatest com o regionCode da empresa.

   Confira um exemplo de solicitação:

   GET https://merchantapi.googleapis.com/accounts/v1beta/termsOfService:retrieveLatest
   

   Confira um exemplo de resposta de uma chamada bem-sucedida:

   {
       "name": "termsOfService/{VERSION}",
       "regionCode": "{COUNTRY}",
       "kind": "MERCHANT_CENTER",
       "fileUri": "{URI}"
   }
   

2. Mostre os TOS do fileUri ao comerciante.

3. Quando o comerciante aceitar os TOS na sua interface, chame termsOfService.accept com o name dos TOS para aceitar.

Depois que o comerciante aceitar os TOS, você poderá usar a API Merchant para configurar o restante das informações da conta. Para saber quais informações da conta podem ser gerenciadas com a API Merchant Accounts, consulte o recurso Account.

Reivindicar seu site

É possível usar a API Merchant Accounts para adicionar e reivindicar o Homepage da sua empresa.

1. Para adicionar uma página inicial à sua conta, chame accounts.updateHomepage com um recurso Homepage que contenha o URL da página inicial.
2. Para reivindicar a propriedade da página inicial, chame accounts.homepage.claim com o name do recurso Hompeage.

Não é possível usar a API Merchant para verificar sua página inicial. Para mais informações, consulte Verificar e reivindicar o site da sua loja.

Atualizar os detalhes da empresa

É possível usar a API Merchant Accounts para editar a PostalAddress, CusomerService e BusinessIdentity da sua empresa.

Identidade da empresa:

• Para conferir a identidade da sua empresa, chame accounts.businessIdentity.getBusinessIdentity.
• Para editar a identidade da sua empresa, ligue para accounts.businessIdentity.updateBusinessIdentity.

A seguir

• Saiba como criar e gerenciar subcontas.
• Para entender como funcionam as relações entre contas de comerciantes, consulte Relações entre contas.