Kataloginformationen verwalten

Auf dieser Seite wird beschrieben, wie Sie Ihre Produktinformationen verwalten, nachdem Sie einen Katalog in Vertex AI Search for Retail importiert. 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 diesem Tutorial erfahren Sie, wie Sie die API verwenden. , die folgende Aktionen ausführen:

  • 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 ein Produktelement 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

Die 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 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);
}

Produktelement 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 abrufen

Sie können aggregierte Informationen zu Ihrem Katalog und der Vorschau Ihrer hochgeladenen Daten aufrufen können Sie Produkte auf dem Tab Katalog der Seite Daten der Search for Retail-Konsole finden.

Qualität der 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“

    Die Seite Datenqualität wird geprüft, ob Sie Katalogdaten aktualisieren müssen, um die Qualität und die Leistungsstufen der Suchleistung freischalten.

Weitere Informationen zum Überprüfen der Suchdatenqualität und zum Anzeigen der Suchleistung siehe Suchleistungsstufen aktivieren.

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. Sie benötigen die IAM-Rolle Retail Admin, um diesen Vorgang ausführen zu können.

  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 ihre neue Konfiguration festzulegen.

  4. Schließen Sie den Import des neuen Katalogs mit der geänderten Ebenenkonfiguration ab: die unter Kataloginformationen importieren ausgewählte Prozedur.

  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.