Sie benötigen ein Merchant Center-Konto, um die Merchant API verwenden zu können. Sie können sie über die Merchant Center-Benutzeroberfläche erstellen.
Wenn Sie mehrere Konten verwalten müssen, können Sie Unterkonten mit der Merchant API erstellen.
Sie können Ihr Konto in der Merchant Center-Benutzeroberfläche oder über die API konfigurieren, wie unten beschrieben.
Merchant Center-Nutzungsbedingungen akzeptieren
Alle Händler müssen die Nutzungsbedingungen des Merchant Centers akzeptieren. So akzeptieren Sie die Nutzungsbedingungen für Ihr eigenes Händlerkonto:
Rufen Sie
accounts.termsOfServiceAgreementStates.retrieveForApplication
an, um herauszufinden, welche Nutzungsbedingungen für Ihr Konto erforderlich sind.Hier ein Beispiel für eine Anfrage:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates:retrieveForApplication
Hier ist eine Beispielantwort für einen erfolgreichen Aufruf:
{ "name": "accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates/MERCHANT_CENTER-{COUNTRY}", "regionCode": {COUNTRY}, "termsOfServiceKind": "MERCHANT_CENTER", "accepted": { "termsOfService": "termsOfService/{VERSION}", "acceptedBy": "accounts/{ACCOUNT_ID}" } }
Rufen Sie
termsOfService.accept
an, um die Nutzungsbedingungen zu akzeptieren.Hier ein Beispiel für eine Anfrage:
GET https://merchantapi.googleapis.com/accounts/v1beta/{name=termsOfService/{VERSION}}:accept
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
Wir empfehlen, eine Benutzeroberfläche zu erstellen, auf der Sie dem Händler die Nutzungsbedingungen anzeigen und ihn bitten, sie zu akzeptieren.
Suchen Sie die Nutzungsbedingungen, die der Händler mit der
regionCode
des Unternehmens übertermsOfService.retrieveLatest
akzeptieren muss.Hier ein Beispiel für eine Anfrage:
GET https://merchantapi.googleapis.com/accounts/v1beta/termsOfService:retrieveLatest
Hier ist eine Beispielantwort für einen erfolgreichen Aufruf:
{ "name": "termsOfService/{VERSION}", "regionCode": "{COUNTRY}", "kind": "MERCHANT_CENTER", "fileUri": "{URI}" }
Zeigen Sie dem Händler die Nutzungsbedingungen der
fileUri
an.Wenn der Händler die Nutzungsbedingungen in Ihrer Benutzeroberfläche akzeptiert, rufen Sie
termsOfService.accept
mit dername
der zu akzeptierenden Nutzungsbedingungen an.
Nachdem der Händler die Nutzungsbedingungen akzeptiert hat, können Sie mit der Merchant API die restlichen Kontoinformationen einrichten. Weitere Informationen dazu, welche Kontoinformationen Sie mit der Merchant Accounts API verwalten können, finden Sie in der Ressource Account
.
Website beanspruchen
Mit der Merchant Accounts API können Sie den Homepage
Ihres Unternehmens hinzufügen und Anspruch darauf erheben.
- Wenn Sie Ihrem Konto eine Startseite hinzufügen möchten, rufen Sie
accounts.updateHomepage
mit einer Ressource vom TypHomepage
auf, die die URL Ihrer Startseite enthält. - Wenn Sie die Inhaberschaft der Startseite beanspruchen möchten, rufen Sie
accounts.homepage.claim
mit demname
aus IhrerHompeage
-Ressource auf.
Sie können Ihre Startseite nicht mit der Merchant API bestätigen. Weitere Informationen finden Sie unter Die Website Ihres Geschäfts bestätigen und beanspruchen.
Unternehmensdetails aktualisieren
Mit der Merchant Accounts API können Sie Ihr Unternehmen PostalAddress
, CusomerService
und BusinessIdentity
bearbeiten.
Unternehmensidentität:
- Rufen Sie
accounts.businessIdentity.getBusinessIdentity
auf, um die Identität Ihres Unternehmens aufzurufen. - Wenn Sie die Identität Ihres Unternehmens bearbeiten möchten, rufen Sie
accounts.businessIdentity.updateBusinessIdentity
an.
Nächste Schritte
- Weitere Informationen zum Erstellen und Verwalten von Unterkonten
- Wie Beziehungen zwischen Händlerkonten funktionieren, erfahren Sie unter Beziehungen zwischen Konten.