Startseiteneinstellungen migrieren

Mit der Merchant API wird eine eigene Homepage Ressource eingeführt. Diese Ressource bietet neue Methoden zum Verwalten Ihres Anspruchs auf die Homepage und bietet 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) war Teil der AccountStatus Ressource.
  • Granulare Methoden: Die Merchant API bietet spezifische Methoden für folgende Aktionen:
  • 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 und liefern so sofort Feedback zum aktuellen Status. In der Content API for Shopping hat accounts.claimwebsite den aktualisierten Status nicht zurückgegeben. Separate Aufrufe waren erforderlich.
  • Explizites Aufheben des Anspruchs: In der Content API for Shopping wurde der Anspruch in der Regel aufgehoben, indem die Account.website_url in einen leeren String geändert 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 (ausgeführt für Account.website_url, festgelegt mit accounts.update) POST /accounts/v1/accounts/{account}/homepage:claim
Anspruch auf Homepage aufheben 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 die Aktion des Beanspruchens konzentrierte, ist jetzt Teil eines breiteren Funktionsumfangs in der Homepage-Ressource der Merchant API.

Methode der Content API for Shopping Methode der Merchant API Verfügbarkeit und Hinweise
accounts.claimwebsite accounts.homepage.claim Leitet direkt einen Anspruch auf eine Website 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 Aufheben des Anspruchs) accounts.homepage.unclaim Neue spezielle Methode zum expliziten Aufheben des Anspruchs auf eine Homepage.

Detaillierte Feldänderungen

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

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 vom Typ „Nur 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 des Anfragetexts) 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