Startseiteneinstellungen migrieren

Die Merchant API führt eine eigene Homepage Ressource ein. Diese Ressource bietet neue Methoden zum Verwalten Ihres Homepage-Anspruchs und damit mehr Möglichkeiten als die klassische Content API for Shopping.

Der Zugriff auf Funktionen für Ihren Onlineshop erfolgt in zwei Schritten: Zuerst müssen Sie das Inhaberverhältnis bestätigen und dann die Website für Ihr Konto beanspruchen. Verwenden Sie für den letzten Schritt die accounts.homepage.claim.

Wichtige Unterschiede

Im Vergleich zur Content API for Shopping gibt es in der Merchant API mehrere Änderungen im Zusammenhang mit der Homepage:

  • Eigene Ressource: Die Merchant API bietet eine separate Homepage Ressource (accounts.homepage) für alle Vorgänge im Zusammenhang mit der Homepage. In der Content API for Shopping haben Sie accounts.claimwebsite verwendet, um den Anspruch zu erheben. Die Homepage-URL (website_url) war Teil der Account Ressource und der Anspruchsstatus (website_claimed) Teil der AccountStatus Ressource.
  • Granulare Methoden: Die Merchant API bietet spezifische Methoden für folgende Vorgänge:
  • Zentrale Informationen: Die Merchant API Homepage Ressource enthält sowohl den uri (die Homepage-URL) als auch den Status claimed direkt. Alle Methoden, die für die Homepage-Ressource ausgeführt werden, geben diese Ressource zurück. So erhalten Sie sofort Feedback zum aktuellen Status. In der Content API for Shopping hat accounts.claimwebsite den aktualisierten Status nicht zurückgegeben. Separate Aufrufe waren erforderlich.
  • Expliziter Anspruchsverzicht: In der Content API for Shopping wurde der Anspruch in der Regel zurückgezogen, indem Account.website_url auf einen leeren String aktualisiert wurde. Die Merchant API bietet eine eigene homepage.unclaim Methode.
  • Anspruch überschreiben: Beide APIs unterstützen während des Anspruchsprozesses einen overwrite Parameter, um einen Anspruch von einem anderen Konto zu übernehmen, wenn das Inhaberverhältnis bestätigt werden kann.

Anfragen

Die Merchant API verwendet separate RESTful-Endpunkte, um verschiedene Aspekte der Homepage zu verwalten.

Beschreibung der Anfrage Content API for Shopping Merchant API
Homepage-Details abrufen accounts.get (zum Lesen von Account.website_url), accountstatuses.get (zum Lesen von AccountStatus.website_claimed) GET /accounts/v1/accounts/{account}/homepage
Homepage-URI aktualisieren accounts.update (Festlegen von Account.website_url) PATCH /accounts/v1/accounts/{account}/homepage
Homepage beanspruchen oder noch einmal bestätigen POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite (für Account.website_url, das mit accounts.update festgelegt wurde) POST /accounts/v1/accounts/{account}/homepage:claim
Homepage-Anspruch zurückziehen accounts.update (Festlegen von Account.website_url auf einen leeren String) POST /accounts/v1/accounts/{account}/homepage:unclaim

IDs

Die Ressourcenidentifikation wurde in der Merchant API optimiert.

Beschreibung der ID Content API for Shopping Merchant API
Konto-ID für den Ressourcenzugriff merchantId (erweitertes Konto) und accountId (Unterkonto) im Pfad account (Teil des Felds name, z. B. accounts/{account_id}/homepage)
Ressourcen-ID der Homepage Nicht zutreffend (implizit für die Account-Ressource) name: accounts/{account_id}/homepage (identifiziert die Homepage-Unterressource)

Methoden

Die Methode accounts.claimwebsite aus der Content API for Shopping, die sich auf den Anspruch konzentrierte, ist jetzt Teil eines breiteren Funktionsumfangs in der Homepage-Ressource der Merchant API.

Content API for Shopping-Methode Merchant API-Methode Verfügbarkeit und Hinweise
accounts.claimwebsite accounts.homepage.claim Leitet direkt einen Website-Anspruch ein oder bestätigt ihn noch einmal. Wird für den uri ausgeführt, der zuvor mit homepage.update festgelegt wurde. Enthält einen overwrite-Parameter. Gibt die Homepage-Ressource mit dem aktuellen uri und dem Status claimed zurück.
accounts.get (zum Lesen von Account.website_url), accountstatuses.get (zum Lesen von AccountStatus.website_claimed) accounts.homepage.getHomepage Neue spezielle Methode zum Abrufen der aktuellen Homepage uri und ihres Status claimed in einem einzigen Aufruf.
accounts.update (zum Festlegen von Account.website_url) accounts.homepage.updateHomepage Neue spezielle Methode zum Festlegen oder Ändern des uri der Homepage.
accounts.update (Festlegen von Account.website_url auf einen leeren String als Umgehungslösung zum Zurückziehen des Anspruchs) accounts.homepage.unclaim Neue spezielle Methode zum expliziten Zurückziehen des Anspruchs auf eine Homepage.

Detaillierte Feldänderungen

Die Strukturierung und der Zugriff auf Homepage-Informationen haben sich erheblich geändert. Sie sind jetzt in der expliziten Homepage-Ressource in der Merchant API zu finden.

Content API for Shopping Merchant API Beschreibung
merchantId (Pfadparameter für accounts.claimwebsite) name (Pfadparameter für Homepage-Methoden, Format: accounts/{account}/homepage) Der account Teil des name Strings in der Merchant API entspricht accountId aus der Content API for Shopping.
accountId (Pfadparameter für accounts.claimwebsite) name (Pfadparameter für Homepage-Methoden, Format: accounts/{account}/homepage) Die ID für das Konto, dessen Homepage verwaltet wird.
overwrite (boolescher Wert im Text von ContentAccountsClaimwebsiteRequest und AccountsCustomBatchRequestEntry) ClaimHomepageRequest.overwrite (boolescher Wert im Text der Anfrage homepage.claim) Optional. Wenn true, wird versucht, die Website zu beanspruchen. Dabei wird möglicherweise ein vorhandener Anspruch von einem anderen Konto entfernt, wenn das Inhaberverhältnis vom anfragenden Konto bestätigt werden kann.
Account.website_url (Feld in der Account-Ressource, festgelegt mit accounts.update, gelesen mit accounts.get) Homepage.uri (Feld in der Homepage-Ressource) Der URI (die URL) der Homepage des Geschäfts. In der Merchant API ist dies ein explizites Feld in der Homepage-Ressource. Es wird mit accounts.homepage.updateHomepage festgelegt und von allen Homepage Methoden zurückgegeben.
AccountStatus.website_claimed (Feld in der AccountStatus-Ressource, gelesen mit accountstatuses.get) Homepage.claimed (boolesches Feld nur für die Ausgabe in der Homepage-Ressource) Gibt an, ob der uri beansprucht und bestätigt wurde. Dieser Status ist direkt in der Homepage-Ressource verfügbar, die von allen zugehörigen Merchant API-Methoden zurückgegeben wird.
– UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage Parameter im Text der Anfrage) Eine optionale Feldmaske für homepage.update, um anzugeben, welche Felder (z.B. uri) der Homepage-Ressource aktualisiert werden.
Zurück
Migrate user and access management
Weiter
Migrate region management