Produkte verwalten
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit der Unter-API „Products“ können Sie Ihr Produktinventar im Google Merchant Center programmatisch verwalten. Sie können Produkte erstellen, abrufen, aktualisieren und löschen und so Ihre Systeme direkt in Google einbinden.
Ein wichtiger Aspekt der Merchant API ist die Unterscheidung zwischen den von Ihnen eingereichten Daten und dem endgültigen Produkt, das von Google verwendet wird. Durch diese Trennung wird der Lebenszyklus der Produktdaten besser nachvollziehbar und Sie haben mehr Kontrolle über Ihre Produktinformationen. Die API spiegelt dies in zwei Hauptressourcen wider:
ProductInput:Dies sind die Rohproduktdaten, die Sie an eine bestimmte Datenquelle senden.
Das ist die Zeile, die Sie in einer Feeddatei hochladen, oder die Daten, die Sie mit einem API-Aufruf einreichen, bevor sie im Merchant Center verarbeitet werden. Sie verwenden diese Ressource für alle Schreibvorgänge (insert, patch, delete).
Product:Dies ist eine schreibgeschützte Ressource, die das endgültige, verarbeitete Produkt darstellt, wie es im Merchant Center und auf Google-Plattformen zu sehen ist. Sie wird aus einer primären ProductInput-Ressource und null oder mehr zusätzlichen ProductInput-Ressourcen erstellt, nachdem alle Feedregeln und die Verarbeitung angewendet wurden. Diese Ressource enthält den endgültigen Status des Produkts und alle Probleme mit der Datenqualität.
Sie verwenden diese Ressource für alle Lesevorgänge (get, list).
Das Format und die Anforderungen für alle Produktattribute, die mit der ProductInput-Ressource eingereicht werden, sind in der Produktdatenspezifikation definiert.
Funktionen der Products-Unter-API
Mit der Unter-API „Products“ können Sie die folgenden wichtigen Aufgaben ausführen. In den Anleitungen finden Sie detaillierte Anleitungen und Codebeispiele für die einzelnen Anwendungsfälle.
- Produkte hinzufügen und verwalten: Hier erfahren Sie, wie Sie Ihrem Konto neue Produkte hinzufügen, zusätzliche Daten für vorhandene Produkte angeben und Produkte löschen, die Sie nicht mehr verkaufen.
- Häufige Aktualisierungen Ihrer Produkte vornehmen: Hier erfahren Sie, wie Sie effiziente, partielle Aktualisierungen von Produktattributen vornehmen, die sich häufig ändern, z. B. Preis und Verfügbarkeit.
- Produktdaten und Produktprobleme auflisten: Hier erfahren Sie, wie Sie Ihre verarbeiteten Produkte abrufen, den Genehmigungsstatus für verschiedene Ziele prüfen und alle Probleme mit der Datenqualität ermitteln, die sich auf die Sichtbarkeit auswirken können.
Hinweis
Bevor Sie die Products-Unter-API verwenden können, müssen Sie mindestens eine API-Datenquelle in Ihrem Merchant Center-Konto erstellen. Mit der Unter-API „Products“ können Produkte nur in Datenquellen vom Typ API eingefügt oder aktualisiert werden. Eine Anleitung finden Sie im Hilfeartikel API-Datenquellen für Produkt-Uploads verwalten.
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: 2025-08-22 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-22 (UTC)."],[[["\u003cp\u003eThe Merchant Products API allows you to programmatically manage your product data, including inserting, updating, retrieving, and deleting products.\u003c/p\u003e\n"],["\u003cp\u003eProducts are managed through two key resources: \u003ccode\u003eproductInputs\u003c/code\u003e (representing input data) and \u003ccode\u003eproducts\u003c/code\u003e (representing processed products in the Shopping database).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eproductInputs\u003c/code\u003e can be primary or supplementary and are used to construct the final \u003ccode\u003eproduct\u003c/code\u003e that appears in your online or local store catalogs.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers advantages over file-based uploads, such as faster response times and real-time updates.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, ensure you have a data source set up and are familiar with Shopping Ads and free listings policies.\u003c/p\u003e\n"]]],["The Merchant Products API allows programmatic product data management via `productInputs` and `products` resources. Actions include inserting `productInput` data with required fields like `channel`, `offerId`, `contentLanguage`, and `feedLabel` using `accounts.productInputs.insert`. Processed products can be retrieved using `accounts.products.get` and listed with `accounts.products.list`. Product inputs are deleted using `accounts.productInputs.delete`, specifying the data source. Products are built from primary and supplemental data sources, enabling real-time catalog management. You can use Batch mode to manage many products.\n"],null,["# Manage your products\n\nThe Products sub-API lets you programmatically manage your product inventory in\nGoogle Merchant Center. You can create, retrieve, update, and delete products,\ngiving you the flexibility to integrate your systems directly with Google.\n\nA key concept in Merchant API is the distinction between the data you submit and\nthe final product that Google uses. This separation provides a clearer model of\nthe product data lifecycle and gives you more precise control over your product\ninformation. The API reflects this with two main resources:\n\n- **[`ProductInput`](/merchant/api/reference/rest/products_v1/accounts.productInputs#ProductInput):**\n This represents the raw product data you submit to a specific data source.\n Think of this as the row you upload in a feed file or the data you submit\n with an API call before any Merchant Center processing happens. You use this\n resource for all **write** operations (`insert`, `patch`, `delete`).\n\n- **[`Product`](/merchant/api/reference/rest/products_v1/accounts.products#Product):**\n This is a read-only resource that represents the final, processed product as\n it appears in Merchant Center and on Google surfaces. It is built from one\n primary `ProductInput` and zero or more supplemental `ProductInput`\n resources after all feed rules and processing have been applied. This\n resource includes the product's final status and any data quality issues.\n You use this resource for all **read** operations (`get`, `list`).\n\nThe format and requirements for all product attributes submitted using the\n`ProductInput` resource are defined in the [Product data\nspecification](https://support.google.com/merchants/answer/7052112).\n\nWhat you can do with the Products sub-API\n-----------------------------------------\n\nThe Products sub-API lets you to perform the following key tasks. Explore the\nguides for detailed instructions and code samples for each use case.\n\n- [Add and manage products](/merchant/api/guides/products/add-manage): Learn how to add new products to your account, provide supplemental data for existing ones, and delete products you no longer sell.\n- [Make frequent updates to your\n products](/merchant/api/guides/products/frequent-updates): Discover how to make efficient, partial updates to product attributes that change often, such as price and availability.\n- [List your products data and product\n issues](/merchant/api/guides/products/list-products-data-issues): Find out how to retrieve your processed products, check their approval status for different destinations, and identify any data quality issues that may be affecting their visibility.\n\nBefore you begin\n----------------\n\nBefore using the Products sub-API, you must create at least one API data source\nin your Merchant Center account. The Products sub-API can only insert or update\nproducts in data sources of type `API`. For instructions, see the [Manage API\ndata sources for product uploads](/merchant/api/guides/data-sources/api-sources) guide."]]
