Diese Seite wurde von der Cloud Translation API übersetzt.

Kontoverwaltung von der Content API for Shopping migrieren

In diesem Dokument wird erläutert, wie Sie von der Content API v2.1 zur Merchant API migrieren.

Änderungen von der Content API 2.1 zur Merchant API

Die Merchant API bietet im Vergleich zur Content API 2.1 erhebliche Verbesserungen, die die Nutzerfreundlichkeit, Konsistenz und Flexibilität für Entwickler und Unternehmen erhöhen sollen.

Detaillierte Ressourcenstruktur

Ressourcen in der Merchant API stehen für einzelne Konzepte wie account, businessDetails, user, homepage und program. Sie sind hierarchisch angeordnet, um ihre Beziehungen widerzuspiegeln. Eine account ist beispielsweise die übergeordnete Ressource für eine user.

Einheitliche Kontodienste

Alle Kontodienste (z. B. Kontoaggregation für Mehrfachkundenkonten und deren Unterkonten oder zwischen Dienstanbietern und Konten von Drittanbietern) werden über eine einheitliche accountService-Ressource verwaltet. Dienstanbieter können ihre Beziehungen über die Ressource accountRelationship verwalten.

Vereinfachte URL-Struktur

Für URLs wird jetzt eine einzelne Konto-ID (z. B. merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}) anstelle mehrerer IDs verwendet. URL-Pfade spiegeln die detaillierte Ressourcenstruktur wider.

Weitere Verbesserungen

Erweiterte Programm- und Nutzerverwaltung: Programme wie Shopping-Anzeigen und Produkteinträge werden in einer einzigen program-Ressource zusammengefasst. Die user-Ressource bietet umfassende Verwaltungsfunktionen mit detaillierten Zugriffsrechten.
Strukturierte Unternehmensinformationen und Unternehmensidentität: Es gibt spezielle Ressourcen für businessInfo und businessIdentity. Sie bieten Compliance-Unterstützung mit Feldern für regionsspezifische Daten. Beispiel: Koreanische Registrierungsnummer für Unternehmen
Vereinfachte Ansprüche auf Startseiten: Die URL der Startseite des Geschäfts wird über eine spezielle Ressource homepage verwaltet. Methoden wie claim und unclaim verwalten Website-Anspruchsrechte direkt über die API.
Einhaltung der Google API-Richtlinien: Die Merchant API soll den API-Verbesserungsvorschlägen von Google entsprechen.

Migration der Kontoverwaltung

Mit der Ressource accounts können Sie Ihr Händlerkonto erstellen und 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:

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

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

	Content API for Shopping	Merchant Accounts API
URL	`https://shoppingcontent.googleapis.com/content/v2.1/`{merchantId}`/accounts/`{accountId}/	`https://merchantapi.googleapis.com/accounts/v1beta/`*{name=accounts/}**
IDs	merchantId`,`accountId	„name

Ressourcen

Die Kontodaten werden über die Ressource Account in der Content API for Shopping übergeben. Die Merchant Accounts API bietet mehrere Ressourcen, um Kontodaten zu übergeben. Dazu gehören Account-, User-, BusinessInfo- und BusinessIdentity-Ressourcen.

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

Content API for Shopping	Merchant Accounts API
`id`	`name`
`name`	`accountName`
`kind`	Nicht verfügbar
`websiteUrl`	Feld `uri` in der Ressource `Homepage`
`adultContent`	`adultContent`
`sellerId`	Feld `accountIdAlias` in der Ressource `AccountRelationship`
`users`	In der `User`-Ressource
`youtubeChannelLinks`	Noch nicht verfügbar
`googleMyBusinessLink`	Noch nicht verfügbar
`businessInformation`	In der `businessInfo`-Ressource
`businessIdentity`	In der `businessIdentity`-Ressource
`automaticImprovements`	Noch nicht verfügbar
`adsLinks`	Feld `campaignsManagement` in der Ressource `AccountService`
`cssId`	Nur in der CSS API verfügbar
`labelIds`	Nur in der CSS API verfügbar
`accountManagement`	Feld `accountManagement` in der Ressource `AccountService`
`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 mit der Ressource User in der Merchant Accounts API verglichen.

Content API for Shopping	Merchant Accounts API
`emailAddress`	E-Mail-Adresse ist Teil des `name` (`accounts/{account}/users/{email}`).
`admin`	`user#accessRights.ADMIN`
`orderManager`	Nicht verfügbar
`paymentsManager`	Nicht verfügbar
`paymentsAnalyst`	Nicht verfügbar
`reportingManager`	`user#accessRights.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	Merchant Accounts API
`address`	`address`
`phoneNumber`	`phone`
`phoneVerificationStatus`	`phoneVerificationState`
`customerService`	`customerService`
`koreanBusinessRegistrationNumber`	`koreanBusinessRegistrationNumber`

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

Content API for Shopping	Merchant Accounts API
`blackOwned`	`blackOwned`
`womenOwned`	`womenOwned`
`veteranOwned`	`veteranOwned`
`latinoOwned`	`latinoOwned`
`smallBusiness`	`smallBusiness`
`includeForPromotions`	`promotionsConsent`
	– `true` steht für `PROMOTION_CONSENT_GIVEN`
	– `false` steht für `PROMOTION_CONSENT_DENIED`

Die Ressource AccountIdentityType in der Content API wird durch den Typ IdentityAttribute und das Feld identityDeclaration in der MerchantAPI dargestellt.

Content API for Shopping	Merchant Accounts API
`self_identified`	`identityDeclaration`
	– `true` steht für `SELF_IDENTIFIES_AS`
	– `false` steht für `DOES_NOT_SELF_IDENTIFY_AS`

Methoden

In der Merchant Accounts API wurden die folgenden Methoden eingeführt:

Content API for Shopping	Merchant Accounts API
`accounts.authinfo`	`GET https://merchantapi.googleapis.com/accounts/v1beta/accounts` ohne Filter
`accounts.claimwebsite`	`POST https://merchantapi.googleapis.com/accounts/v1beta/`*{parent=accounts/}**`/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/`*{name=accounts/}**
`accounts.get`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`*{name=accounts/}**`
`accounts.insert`	`POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure` Weitere Informationen finden Sie unter Händlerkonto erstellen und konfigurieren.
`accounts.link`	`AccountService`-Ressource
`accounts.list`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`*{parent=accounts/}**`:listSubaccounts`
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`*{parent=accounts/}**`/services`
`accounts.requestphoneverification`	Nicht unterstützt.
`accounts.update`	Wird einer Aktualisierungsanfrage für die Ressource zugeordnet, in der das erforderliche Feld oder die erforderlichen Felder definiert sind.
`accounts.updatelabels`	Nur in der CSS API verfügbar
`accounts.verifyphonenumber`	Nicht unterstützt.

Zurück

Übersicht

Weiter

Inventarverwaltung migrieren