Dies ist die Dokumentation nur für Recommendations AI. Wenn Sie Retail Search und die einheitliche Retail-Konsole in der eingeschränkten GA-Phase ausprobieren möchten, wenden Sie sich an den Cloud-Vertrieb. Wenn Sie Retail Search nicht verwenden möchten, können Sie das bis auf Weiteres in der Empfehlungskonsole bleiben.

Wenn Sie die v1beta-Version von Recommendations AI verwenden, migrieren Sie zur Retail API-Version.

Von der Betaversion zur Retail API migrieren

Recommendations AI verwendet jetzt die Retail API. Auf dieser Seite werden die eingeführten Änderungen und Best Practices für die Migration beim Wechsel von der v1beta1-Version der Recommendations Engine API (Dienstendpunkt https://recommendationengine.googleapis.com) zur allgemein verfügbaren Retail API (Dienstendpunkt https://retail.googleapis.com) erläutert.

Die Recommendations Engine API und ihr Dokumentationssatz sind weiterhin verfügbar, werden jedoch nicht mehr aktualisiert.

Dieses Dokument betrifft Sie nur, wenn Sie die Recommendations AI mit der Betaversion genutzt haben.

Best Practices

  • Senden Sie nur validierten Traffic vor der vollständigen Migration.
  • Die inkrementelle Trafficmigration ist besser als die gleichzeitige Umstellung. Migrieren Sie Ihren Traffic nach Möglichkeit schrittweise von v1beta1 zu v2.
  • Wenn Sie Dienste in verschiedenen Regionen ausführen, ist es besser, die Regionen nacheinander zu migrieren, um einen globalen Ausfall zu vermeiden.

Änderungen in der Dokumentation

Diese Dokumentationsreihe bezieht sich auf die allgemein verfügbare Retail API.

Die Beta-Dokumentation für die Recommendations Engine API und deren Dokumentation ist weiterhin verfügbar, wird jedoch nicht mehr aktualisiert. Die Beta-Dokumentation finden Sie unten:

REST- und RPC-Pfade

An den REST- und RPC-Pfaden wurden viele Änderungen vorgenommen. Lesen Sie die API-Dokumentation für die Retail API, um sicherzustellen, dass Sie die Retail API ordnungsgemäß aufrufen.

Für alle Pfade wird jetzt retail.googleapis.com anstelle von recommendationengine.googleapis.com verwendet.

Beispiel:

v1beta1 Recommendations Engine API:

GET https://recommendationengine.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID

V2 Retail API:

GET https://retail.googleapis.com/v2/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID

Einige Ressourcen und Methoden wurden umbenannt, entfernt oder neu hinzugefügt. Verwenden Sie die folgende Tabelle, um v1beta1-Ressourcen mit denen von v2 zu vergleichen.

Links zu v1beta1-Ressourcen finden Sie in der API-Dokumentation für v1beta1.

v1beta1-Ressource Methode v2-Ressource Methode
catalogs list catalogs list
patch patch
catalogs.branches.operations get
catalogs.catalogItems create catalogs.branches.products create
delete delete
get get
import import
list Entfernt
patch patch
catalogs.operations get catalogs.operations get
list list
catalogs.eventStores.operations get Entfernt
list
catalogs.eventStores.placements predict catalogs.placements predict
catalogs.eventStores.predictionApiKeyRegistrations create Entfernt
delete
list
catalogs.eventStores.userEvents collect catalogs.userEvents collect
import import
list Entfernt
purge purge
rejoin rejoin
write write
operations get
list

IAM-Änderungen

Die folgenden Änderungen wurden an die Rollen und Berechtigungen von Identity and Access Management (IAM) von Recommendations AI eingeführt:

  • Recommendations AI verwendet IAM-Rollen und -Berechtigungen im Namespace retail anstelle des Namespace automlrecommendations, der von Recommendations Engine v1beta1 verwendet wurde.
  • Die Rolle Admin Viewer wurde entfernt.
  • Berechtigungen für apiKeys wurden entfernt, da die predict-Methode keinen eigenen API-Schlüssel mehr benötigt.

Katalog- und Nutzerereignisschemas

Die Schemas für Katalog- und Nutzerereignisse wurden in der Retail API geändert.