Kataloginformationen verwalten

Auf dieser Seite wird beschrieben, wie Sie Ihre Produktinformationen verwalten, nachdem Sie einen Katalog in Vertex AI Search für den Einzelhandel 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 API-Methoden verwenden, mit denen die folgenden Aktionen ausgeführt werden:

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

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

Anleitung

Anleitung zum Erstellen eines Produkts

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

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

Anleitung

Anleitung zum Herunterladen von Produkten

In dieser Anleitung erfahren Sie, wie Sie einen Produktartikel abrufen.

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

Anleitung

Anleitung zum Aktualisieren von Produkten

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

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

Anleitung

Anleitung zum Löschen eines Produkts

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

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

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": "CATEGORY"
    }' \
    "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": [
    "CATEGORY"
  ],
  "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": [
    "Parent category > Child category"
  ],
  "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

Auch wenn Sie mit der API Produkte aus Ihrem Katalog löschen können, beachten Sie: Wenn Sie ein Nutzerereignis aufzeichnen, das sich auf ein gelöschtes Produktelement bezieht, kann die API das Nutzerereignis nicht ordnungsgemäß verarbeiten und es wird möglicherweise gelöscht. 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": [
      "Parent category > Child category"
    ],
    "title": "product title",
    "availability": "IN_STOCK"
}

Java

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

Zusammengefasste Informationen zu Ihrem Katalog ansehen

Auf dem Tab Katalog der Seite Daten der Search for Retail-Konsole können Sie zusammengefasste Informationen zu Ihrem Katalog ansehen und hochgeladene Produkte als Vorschau ansehen.

Qualität von Katalogdaten bewerten

So bewerten Sie die Qualität Ihrer Katalogdaten:

  1. Rufen Sie in der Search for Retail-Konsole die Seite Datenqualität auf.

    Zur Seite „Datenqualität“

    Auf der Seite Datenqualität wird bewertet, ob Sie Katalogdaten aktualisieren müssen, um die Qualität Ihrer Suchergebnisse zu verbessern und Stufen für die Suchleistung zu nutzen.

Weitere Informationen zum Prüfen der Qualität der Suchdaten und zum Aufrufen von Stufen für die Suchleistung finden Sie unter Stufen für die Suchleistung freischalten.

Eine Zusammenfassung der verfügbaren Katalogmesswerte finden Sie unter Katalogqualitätsmesswerte.

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 in der Referenzdokumentation unter product.Type.

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 Retail Admin.

  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 dem entsprechenden Verfahren unter Kataloginformationen importieren, um die Produktebenen auf die neue Konfiguration festzulegen.

  4. Schließen Sie den Import des neuen Katalogs mit der geänderten Konfigurationsebene ab. Verwenden Sie dazu das Verfahren, das Sie unter Kataloginformationen importieren ausgewählt haben.

  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 „Modelle“

    Weitere Informationen zu den Optimierungskosten finden Sie unter Preise.