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.

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.

Confira um exemplo que pode ser usado para aceitar o Contrato de Termos de Serviço de uma conta:

Python

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_accounts_v1beta import AcceptTermsOfServiceRequest
from google.shopping.merchant_accounts_v1beta import TermsOfServiceServiceClient

# Replace with your actual values.
_ACCOUNT_ID = configuration.Configuration().read_merchant_info()
_TOS_VERSION = (  # Replace with the Terms of Service version to accept
    "VERSION_HERE"
)
_REGION_CODE = "US"  # Replace with the region code


def accept_terms_of_service():
  """Accepts the Terms of Service agreement for a given account."""

  credentials = generate_user_credentials.main()
  client = TermsOfServiceServiceClient(credentials=credentials)

  # Construct the request
  request = AcceptTermsOfServiceRequest(
      name=f"termsOfService/{_TOS_VERSION}",
      account=f"accounts/{_ACCOUNT_ID}",
      region_code=_REGION_CODE,
  )

  try:
    print("Sending request to accept terms of service...")
    client.accept_terms_of_service(request=request)
    print("Successfully accepted terms of service.")
  except RuntimeError as e:
    print(e)


if __name__ == "__main__":
  accept_terms_of_service()

accept_terms_of_service_sample.py

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 você pode gerenciar 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:

A seguir

Anterior
Overview
Próxima
Create and manage sub-accounts