Dies ist die Dokumentation für Recommendations AI, Retail Search und die neue Retail Console.

Kataloginformationen verwalten

Auf dieser Seite wird beschrieben, wie Sie Ihre Produktinformationen verwalten, nachdem Sie einen Katalog in die Retail API importiert haben. Sie können Produkte in Ihrem Katalog lesen, schreiben und löschen.

Wenn Sie Ihren Katalog bei Änderungen der Produktinformationen auf dem neuesten Stand halten möchten, importieren Sie den Katalog genauso wie beim ersten Mal. Informationen zum Importieren Ihres Katalogs finden Sie unter Kataloginformationen importieren.

Anleitung zum Erstellen, Abrufen, Aktualisieren und Löschen von Produkten

In dieser Anleitung erfahren Sie, wie Sie die Produktdienstmethoden der Retail API verwenden, die die folgenden Aktionen ausführen:

  • Produkt erstellen
  • Produkt kaufen
  • Produkt aktualisieren
  • Produkt löschen

Eine detaillierte Anleitung zu dieser Aufgabe finden Sie direkt im Cloud Shell-Editor. Klicken Sie dazu einfach auf Anleitung:

Anleitung


Die folgenden Abschnitte führen Sie durch dieselben Schritte wie das Klicken auf Anleitung.

Anleitung zum Erstellen eines Produkts

In dieser Anleitung erfahren Sie, wie Sie ein einzelnes Produkt erstellen.


Eine detaillierte Anleitung zu dieser Aufgabe finden Sie direkt im Cloud Shell-Editor. Klicken Sie dazu einfach auf Anleitung:

Anleitung


Die folgenden Abschnitte führen Sie durch dieselben Schritte wie das Klicken auf Anleitung.

Anleitung zum Herunterladen von Produkten

In dieser Anleitung erfahren Sie, wie Sie ein Produktelement abrufen.


Eine detaillierte Anleitung zu dieser Aufgabe finden Sie direkt im Cloud Shell-Editor. Klicken Sie dazu einfach auf Anleitung:

Anleitung


Die folgenden Abschnitte führen Sie durch dieselben Schritte wie das Klicken auf Anleitung.

Anleitung zum Aktualisieren von Produkten

In dieser Anleitung erfahren Sie, wie Sie ein Produkt in einem Katalog aktualisieren.


Eine detaillierte Anleitung zu dieser Aufgabe finden Sie direkt im Cloud Shell-Editor. Klicken Sie dazu einfach auf Anleitung:

Anleitung


Die folgenden Abschnitte führen Sie durch dieselben Schritte wie das Klicken auf Anleitung.

Anleitung zum Löschen eines Produkts

In dieser Anleitung erfahren Sie, wie Sie ein Produkt aus einem Katalog löschen.


Eine detaillierte Anleitung zu dieser Aufgabe finden Sie direkt im Cloud Shell-Editor. Klicken Sie dazu einfach auf Anleitung:

Anleitung


Die folgenden Abschnitte führen Sie durch dieselben Schritte wie das Klicken auf Anleitung.

Produkt hochladen

curl

Erstellen Sie ein einzelnes Produktelement mithilfe der REST-Methode products.create.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
      "title": "PRODUCT_TITLE",
      "categories": "Shoes & Accessories > Shoes"
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products?productID=PRODUCT_ID"

Wenn die Anfrage erfolgreich ist, wird das Produktobjekt zurückgegeben, wie im folgenden Beispiel zu sehen ist.

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": [
    "Shoes & Accessories \u003e Shoes"
  ],
  "title": "product title",
  "availability": "IN_STOCK"
}

Java

public static Product createProduct(Product productToCreate, String productId)
    throws IOException {
  return getProductServiceClient().createProduct(
      DEFAULT_BRANCH_NAME, productToCreate, productId
  );
}

Produktinformationen aktualisieren

Wenn sich Ihr Produktkatalog ändert, können Sie Ihren Katalog aktualisieren, indem Sie Produktänderungen wie neue Produkte, Preise und Lagerstatus in Echtzeit hochladen. Sie können nur Produkte hochladen, die hinzugefügt oder geändert wurden. Es ist nicht erforderlich, dass Sie den gesamten Katalog neu laden.

curl

Produktinformationen mit der Methode products.patch aktualisieren.

Im folgenden Beispiel wird der Titel für ein bestimmtes Produkt aktualisiert:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
       "title": "new-title-value"
    }" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID?updateMask=title"

Wenn die Anfrage erfolgreich ist, wird das Produktobjekt zurückgegeben, wie im folgenden Beispiel zu sehen ist.

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": [
    "Shoes & Accessories > Shoes"
  ],
  "title": "new product title",
  "availability": "IN_STOCK"
}

Java

public static Product updateProduct(Product productToUpdate) throws IOException {
  return getProductServiceClient().updateProduct(productToUpdate, FieldMask.getDefaultInstance());
}

Produktinformationen löschen

Die Retail API bietet die Möglichkeit, Produkte aus Ihrem Katalog zu löschen. Wenn Sie jedoch ein Nutzerereignis erfassen, das sich auf einen gelöschten Produktartikel bezieht, kann die Retail API das Nutzerereignis nicht verarbeiten und es könnte gelöscht werden. Darüber hinaus verbessert die Einbindung von Katalogdaten die Qualität Ihres Modells und ist für gute Empfehlungen und Suchergebnisse von entscheidender Bedeutung.

Sie sollten die availability von veralteten Produkten auf OUT_OF_STOCK setzen, anstatt sie zu löschen.

curl

Löschen Sie ein Produkt mit der Methode delete. Ersetzen Sie PRODUCT_ID dabei durch die ID des zu löschenden Produkts.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

Java

public static void deleteProduct(String productName) throws IOException {
  getProductServiceClient().deleteProduct(productName);
}

Produktartikel abrufen

curl

Zum Abrufen eines Produktelements senden Sie eine GET-Anfrage an den Endpunkt products und ersetzen PRODUCT_ID durch die ID des abzurufenden Produkts.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"  \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

Die Ausgabe sollte in etwa so aussehen:

{
    "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"
    "id": "PRODUCT_ID",
    "primaryProductId": "PRODUCT_ID",
    "type": "PRIMARY",
    "categories": [
      "Shoes & Accessories \u003e Shoes"
    ],
    "title": "product title",
    "availability": "IN_STOCK"
}

Java

public static Product getProduct(String productName) throws IOException {
  return getProductServiceClient().getProduct(productName);
}

Zusammengefasste Informationen zu Ihrem Katalog anzeigen

Auf dem Tab "Katalog" auf der Seite Retail-Daten können Sie aggregierte Informationen zu Ihrem Katalog und eine Vorschau der hochgeladenen Produktelemente aufrufen.

Produkttypen ändern

Beim Importieren eines Produkts können Sie angeben, ob der Typ des Produkts "primary", "variant“ oder "collection" ist. Wenn sich der Typ eines Produkts ändert oder falsch angegeben wurde, müssen Sie das Produkt löschen und mit dem aktualisierten Typ erstellen.

Der Typ eines Produkts kann auf TYPE_UNSPECIFIED, PRIMARY, VARIANT oder COLLECTION festgelegt werden. Weitere Informationen finden Sie unter product.Type in der Referenzdokumentation.

Konfiguration auf Produktebene ändern

Beim Importieren eines Katalogs über das Merchant Center müssen Sie angeben, ob es sich bei den Produkten um "primaries" oder "variants" handelt. Wenn sich diese Produktebenen ändern oder falsch angegeben wurden, korrigieren Sie die Konfiguration mit dem folgenden Verfahren. Für diesen Vorgang benötigen Sie die IAM-Rolle Einzelhandelsadministrator.

  1. Achten Sie darauf, dass keine Importe stattfinden, während Sie die Produktebenen neu konfigurieren. Dadurch werden Daten nicht auf der falschen Ebene hochgeladen.

  2. Löschen Sie alle Produktelemente. Weitere Informationen finden Sie unter products.delete. Der Katalog muss vollständig leer sein, bevor Sie mit dem nächsten Schritt fortfahren können.

  3. Importieren Sie die Daten noch einmal, um die Konfiguration auf Produktebene zu ändern.

    Dieses Verfahren hängt vom Importverfahren ab. Folgen Sie der entsprechenden Anleitung unter Kataloginformationen importieren, um die Produktebenen auf die neue Konfiguration festzulegen.

  4. Schließen Sie den Import des neuen Katalogs mit der Konfiguration der geänderten Ebene ab. Verwenden Sie dabei das ausgewählte Verfahren unter Kataloginformationen importieren.

  5. Alle vorhandenen Modelle optimieren

    Rufen Sie zum Optimieren eines Modells die Seite "Modelle" auf, klicken Sie auf den Namen des Modells, um die zugehörige Detailseite aufzurufen, und klicken Sie dann in der Schaltflächenleiste auf Manuelle Optimierung.

    Zur Seite "Retail-Modelle"

    Weitere Informationen zur Feinabstimmung der Kosten finden Sie unter Preise.