Creare e configurare un account commerciante

Per utilizzare l'API Merchant, devi disporre di un account Merchant Center. Puoi utilizzare l'interfaccia utente di Merchant Center per crearlo.

Se devi gestire più account, puoi creare subaccount utilizzando l'API Merchant.

Puoi configurare il tuo account nell'interfaccia utente di Merchant Center o tramite l'API come descritto di seguito.

Accettare i Termini di servizio di Merchant Center

Tutti i commercianti devono accettare i Termini di servizio di Merchant Center. Ecco come accettare i Termini di servizio per il tuo account commerciante:

1. Chiamare accounts.termsOfServiceAgreementStates.retrieveForApplication per scoprire quali Termini di servizio sono obbligatori per il tuo account.

   Ecco una richiesta di esempio:

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

   Ecco un esempio di risposta di una chiamata andata a buon fine:

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

2. Chiama termsOfService.accept per accettare i Termini di servizio.

   Ecco una richiesta di esempio:

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

   In caso di esito positivo, il corpo della risposta sarà vuoto.

Attenzione: non accettare i Termini di servizio per conto di un altro commerciante. Mostra invece i Termini di servizio al commerciante e chiedigli di accettarli.

Ti consigliamo di creare un'interfaccia utente in cui mostrare al commerciante i TdS e chiedergli di accettarli.

1. Trova i TdS che il commerciante deve accettare utilizzando termsOfService.retrieveLatest con il regionCode dell'attività.

   Ecco una richiesta di esempio:

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

   Ecco un esempio di risposta di una chiamata andata a buon fine:

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

2. Mostra i Termini di servizio di fileUri al commerciante.

3. Quando il commerciante accetta i TdS nella tua UI, chiama termsOfService.accept con il name dei TdS da accettare.

Dopo che il commerciante ha accettato i TdS, puoi utilizzare l'API Merchant per configurare il resto dei dati dell'account. Per informazioni dettagliate sui dati dell'account che puoi gestire con l'API Merchant Accounts, consulta la risorsa Account.

Rivendicare il tuo sito web

Puoi utilizzare l'API Merchant Accounts per aggiungere e rivendicare il Homepage della tua attività.

1. Per aggiungere una home page al tuo account, chiama accounts.updateHomepage con una Homepage risorsa contenente l'URL della home page.
2. Per rivendicare la proprietà della home page, chiama accounts.homepage.claim con il name della tua risorsa Hompeage.

Non puoi utilizzare l'API Merchant per verificare la tua home page. Per ulteriori informazioni, consulta Verificare e rivendicare il sito web del tuo negozio.

Aggiornare i dettagli dell'attività

Puoi utilizzare l'API Merchant Accounts per modificare la tua attività PostalAddress, CusomerService, e BusinessIdentity.

Identità dell'attività:

• Per visualizzare l'identità della tua attività, chiama accounts.businessIdentity.getBusinessIdentity.
• Per modificare l'identità della tua attività, chiama accounts.businessIdentity.updateBusinessIdentity.

Passaggi successivi

• Scopri come creare e gestire subaccount.
• Per comprendere il funzionamento delle relazioni tra gli account dei commercianti, consulta Relazioni tra account.