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:
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}" } }
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.
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}" }
Afficher les conditions d'utilisation de
fileUri
au marchandLorsque le marchand accepte les conditions d'utilisation dans votre UI, appelez
termsOfService.accept
avec lename
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.
- Pour ajouter une page d'accueil à votre compte, appelez
accounts.updateHomepage
avec une ressourceHomepage
contenant l'URL de votre page d'accueil. - Pour revendiquer la propriété de la page d'accueil, appelez
accounts.homepage.claim
avec l'name
de votre ressourceHompeage
.
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:
- Pour afficher l'identité de votre entreprise, appelez
accounts.businessIdentity.getBusinessIdentity
. - Pour modifier l'identité de votre entreprise, appelez le
accounts.businessIdentity.updateBusinessIdentity
.
Étape suivante
- Découvrez comment créer et gérer des sous-comptes.
- Pour comprendre comment fonctionnent les relations entre les comptes marchands, consultez la section Relations entre les comptes.