Créer et configurer un compte marchand

Vous devez disposer d'un compte Merchant Center pour utiliser l'API Merchant. Vous pouvez le créer dans l'interface utilisateur de Merchant Center.

Si vous devez gérer plusieurs comptes, vous pouvez créer des sous-comptes à l'aide de Merchant API.

Vous pouvez configurer votre compte dans l'interface utilisateur de Merchant Center ou via l'API, comme décrit plus loin.

Accepter les conditions d'utilisation de Merchant Center

Tous les marchands doivent accepter les Conditions d'utilisation de Merchant Center. Pour accepter les conditions d'utilisation de votre propre compte marchand, procédez comme suit:

  1. Appelez accounts.termsOfServiceAgreementStates.retrieveForApplication pour connaître les conditions d'utilisation requises pour votre compte.

    Voici un exemple de requête:

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

    Voici un exemple de réponse à un appel réussi:

    {
        "name": "accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates/MERCHANT_CENTER-{COUNTRY}",
        "regionCode": {COUNTRY},
        "termsOfServiceKind": "MERCHANT_CENTER",
        "accepted": {
          "termsOfService": "termsOfService/{VERSION}",
          "acceptedBy": "accounts/{ACCOUNT_ID}"
        }
    }
    
  2. Appelez le numéro termsOfService.accept pour accepter les conditions d'utilisation.

    Voici un exemple de requête:

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

    Si la requête aboutit, le corps de la réponse sera vide.

Nous vous recommandons de créer une UI dans laquelle vous affichez les conditions d'utilisation au marchand et lui demandez de les accepter.

  1. Recherchez les conditions d'utilisation que le marchand doit accepter à l'aide de termsOfService.retrieveLatest avec l'regionCode de l'établissement.

    Voici un exemple de requête:

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

    Voici un exemple de réponse à un appel réussi:

    {
        "name": "termsOfService/{VERSION}",
        "regionCode": "{COUNTRY}",
        "kind": "MERCHANT_CENTER",
        "fileUri": "{URI}"
    }
    
  2. Afficher les conditions d'utilisation de fileUri au marchand

  3. Lorsque le marchand accepte les conditions d'utilisation dans votre UI, appelez termsOfService.accept avec le name des conditions d'utilisation à accepter.

Une fois que le marchand a accepté les conditions d'utilisation, vous pouvez utiliser Merchant API pour configurer le reste des informations de son compte. Pour en savoir plus sur les informations de compte que vous pouvez gérer avec l'API Merchant Accounts, consultez la ressource Account.

Revendiquer votre site Web

Vous pouvez utiliser l'API Merchant Accounts pour ajouter et revendiquer le Homepage de votre entreprise.

  1. Pour ajouter une page d'accueil à votre compte, appelez accounts.updateHomepage avec une ressource Homepage contenant l'URL de votre page d'accueil.
  2. Pour revendiquer la propriété de la page d'accueil, appelez accounts.homepage.claim avec l'name de votre ressource Hompeage.

Vous ne pouvez pas utiliser l'API Merchant pour valider votre page d'accueil. Pour en savoir plus, consultez Valider et revendiquer le site Web de votre magasin.

Modifier les informations sur votre établissement

Vous pouvez utiliser l'API Merchant Accounts pour modifier votre établissement PostalAddress, CusomerService et BusinessIdentity.

Identité de l'entreprise:

Étape suivante