Kontoverwaltung von der Content API for Shopping migrieren

Du kannst die Ressource accounts verwenden, um dein Händlerkonto zu erstellen und zu verwalten. Weitere Informationen finden Sie unter Übersicht über die Merchant Accounts API.

Auf dieser Seite wird beschrieben, wie Sie die Kontoverwaltung von der Content API zur Merchant API migrieren.

Anfragen

Verwenden Sie für die Merchant Accounts API das folgende Anfrage-URL-Format:

POST https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts

Hier ein Beispiel für einen Vergleich der Content API for Shopping mit der Merchant Accounts API bei Anfragen zur Kontoerstellung und -verwaltung:

Content API for Shopping Händlerkonten-API
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/ https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
IDs {merchantId}/accounts/{accountId} {accountId}

Weitere Informationen

Die Kontodaten werden in der Content API for Shopping mithilfe der Ressource Account übergeben. Die Merchant Accounts API bietet mehrere Ressourcen zur Übergabe von Kontodaten. Zu diesen Ressourcen gehören Account, User, BusinessInfo und BusinessIdentity.

In der folgenden Tabelle wird die Ressource Account in der Content API for Shopping und die Ressource Account in der Merchant Accounts API verglichen.

Content API for Shopping Händlerkonten-API
id account_id
name account_name
kind Nicht verfügbar
websiteUrl Feld uri in der Ressource homepage
adultContent adult_content
sellerId Nicht verfügbar
users In User Ressource
youtubeChannelLinks Noch nicht verfügbar
googleMyBusinessLink Noch nicht verfügbar
businessInformation In businessInfo Ressource
businessIdentity In businessIdentity Ressource
automaticImprovements Noch nicht verfügbar
adsLinks Noch nicht verfügbar
cssId Nur in der CSS API verfügbar
labelIds Nur in der CSS API verfügbar
accountManagement Noch nicht verfügbar
automaticLabelIds Nur in der CSS API verfügbar
conversionSettings Noch nicht verfügbar

In der folgenden Tabelle wird die Ressource AccountUser in der Content API for Shopping und die Ressource User in der Merchant Accounts API verglichen.

Content API for Shopping Händlerkonten-API
emailAddress email ist Teil der name
(accounts/{account}/users/{email}).
admin user#access_rights.ADMIN
orderManager Nicht verfügbar
paymentsManager Nicht verfügbar
paymentsAnalyst Nicht verfügbar
reportingManager user#access_rights.PERFORMANCE_REPORTING

In der folgenden Tabelle wird die Ressource AccountBusinessInformation in der Content API for Shopping mit der entsprechenden Ressource businessinfo in der Merchant Accounts API verglichen.

Content API for Shopping Händlerkonten-API
businessInformation businessinfo
phoneNumber phone
phoneVerificationStatus phone_verification_state
customerService customer_service
koreanBusinessRegistrationNumber Nicht verfügbar

In der folgenden Tabelle wird die Ressource AccountBusinessIdentity in der Content API for Shopping und die Ressource businessIdentity in der Merchant Accounts API verglichen.

Content API for Shopping Händlerkonten-API
blackOwned black_owned
womenOwned women_owned
veteranOwned veteran_owned
latinoOwned latino_owned
smallBusiness small_business
includeForPromotions promotions_consent
true steht für PROMOTION_CONSENT_GIVEN
false steht für PROMOTION_CONSENT_DENIED

In der folgenden Tabelle wird die Ressource AccountIdentityType in der Content API for Shopping und die Ressource identityAttribute in der Merchant Accounts API verglichen.

Content API for Shopping Händlerkonten-API
self_identified identity_declaration
true steht für SELF_IDENTIFIES_AS
false steht für DOES_NOT_SELF_IDENTIFY_AS

Methoden

Die folgenden Methoden wurden in der Merchant Accounts API eingeführt:

Content API for Shopping Händlerkonten-API
accounts.authinfo GET https://merchantapi.googleapis.com/accounts/v1beta/accounts ohne Filter
accounts.claimwebsite POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId/homepage:claim
Weitere Informationen finden Sie unter Methode: accounts.v1beta.accounts.homepage.claim.
accounts.custombatch Nicht verfügbar. Benutzerdefinierte Batches werden in der Merchant API nicht unterstützt.
accounts.delete DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId
accounts.get Entspricht einer GET-Anfrage für die Ressource, in der das Pflichtfeld oder die Gruppe von Feldern definiert ist.
accounts.insert POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure
Weitere Informationen finden Sie unter Händlerkonto erstellen und konfigurieren.
accounts.link Noch nicht unterstützt
accounts.list GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks Noch nicht unterstützt
accounts.update Entspricht einer Aktualisierungsanfrage für die Ressource, in der das Pflichtfeld oder die Gruppe von Feldern definiert ist.