Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Kataloginformationen verwalten

Auf dieser Seite wird beschrieben, wie Sie Produktinformationen verwalten, nachdem Sie einen Katalog in AI Commerce Search 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.

Anleitungen zum Erstellen, Aufrufen und Verwalten von Produkten

In dieser Anleitung wird beschrieben, wie Sie die API-Methoden verwenden, mit denen die folgenden Aktionen ausgeführt werden:

Produkt erstellen
Produkt abrufen
Produkt aktualisieren
Produkt löschen

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

Produkt erstellen

In dieser Anleitung wird beschrieben, 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:

Produkt abrufen

In dieser Anleitung wird beschrieben, wie Sie ein Produktelement abrufen.

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

Produkt aktualisieren

In dieser Anleitung wird beschrieben, 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:

Produkt löschen

In dieser Anleitung wird beschrieben, 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:

Einzelnes Produktelement hochladen

curl

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

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 products.patch Methode 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 delete Methode. Ersetzen Sie dabei PRODUCT_ID 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 products-Endpunkt 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

Sie können zusammengefasste Informationen zu Ihrem Katalog und eine Vorschau der hochgeladenen Produkte auf dem Tab Katalog auf der Seite Daten der AI Commerce Search in der Gemini Enterprise for Customer Experience Console aufrufen.

Qualität der Katalogdaten bewerten

So bewerten Sie die Qualität Ihrer Katalogdaten:

Rufen Sie in der Gemini Enterprise for Customer Experience Console die Seite Datenqualität der AI Commerce Search 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 Leistungsstufen für die Suche freizuschalten.

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

Eine Zusammenfassung der verfügbaren Katalogmesswerte finden Sie unter Qualitätsmesswerte für Kataloge.

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 der 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 die Produktebenen ändern oder falsch angegeben wurden, korrigieren Sie die Konfiguration mit dieser Anleitung. Sie benötigen die IAM-Rolle Retail-Administrator , um diese Anleitung auszuführen.

Achten Sie darauf, dass keine Importe stattfinden, während Sie die Produktebenen neu konfigurieren. So wird verhindert, dass Daten auf der falschen Ebene hochgeladen werden.
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.
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.
Schließen Sie den Import des neuen Katalogs mit der geänderten Ebenenkonfiguration ab. Gehen Sie dabei wie unter Kataloginformationen importieren beschrieben vor.
Alle vorhandenen Modelle optimieren

Rufen Sie zum Optimieren eines Modells die Seite „Modelle“ auf, klicken Sie auf den Modell namen, 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.

Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.

Zuletzt aktualisiert: 2026-05-08 (UTC).