Gestisci i tuoi prodotti
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La sub-API Prodotti ti consente di gestire in modo programmatico l'inventario dei prodotti in
Google Merchant Center. Puoi creare, recuperare, aggiornare ed eliminare i prodotti,
il che ti offre la flessibilità di integrare i tuoi sistemi direttamente con Google.
Un concetto chiave dell'API Merchant è la distinzione tra i dati che invii e
il prodotto finale utilizzato da Google. Questa separazione fornisce un modello più chiaro del ciclo di vita dei dati di prodotto e ti offre un controllo più preciso sulle informazioni sui prodotti. L'API riflette questo aspetto con due risorse principali:
ProductInput:
Rappresenta i dati di prodotto non elaborati che invii a un'origine dati specifica.
Consideralo come la riga che carichi in un file di feed o i dati che invii
con una chiamata API prima che venga eseguito qualsiasi trattamento di Merchant Center. Utilizzi questa risorsa per tutte le operazioni di scrittura (insert, patch, delete).
Product:
Questa è una risorsa di sola lettura che rappresenta il prodotto finale elaborato così come appare in Merchant Center e sulle piattaforme Google. È creato da una risorsa
principale ProductInput e da zero o più risorse supplementari ProductInput
dopo l'applicazione di tutte le regole del feed e l'elaborazione. Questa
risorsa include lo stato finale del prodotto e qualsiasi problema di qualità dei dati.
Utilizzi questa risorsa per tutte le operazioni di lettura (get, list).
Il formato e i requisiti per tutti gli attributi di prodotto inviati utilizzando la risorsa
ProductInput sono definiti nella specifica dei dati di
prodotto.
Cosa puoi fare con la sub-API Products
La sotto-API Products ti consente di eseguire le seguenti attività chiave. Esplora le guide per istruzioni dettagliate ed esempi di codice per ogni caso d'uso.
- Aggiungere e gestire i prodotti: scopri
come aggiungere nuovi prodotti al tuo account, fornire dati supplementari per
quelli esistenti ed eliminare i prodotti che non vendi più.
- Aggiorna spesso i tuoi prodotti: scopri come apportare aggiornamenti parziali ed efficienti agli attributi dei prodotti che cambiano spesso, come prezzo e disponibilità.
- Elenca i dati dei prodotti e i problemi
relativi ai prodotti: scopri
come recuperare i prodotti elaborati, controllarne lo stato di approvazione per
diverse destinazioni e identificare eventuali problemi di qualità dei dati che potrebbero
influire sulla loro visibilità.
Prima di iniziare
Prima di utilizzare la sub-API Products, devi creare almeno un'origine dati API
nel tuo account Merchant Center. La sotto-API Products può inserire o aggiornare
i prodotti nelle origini dati di tipo API. Per istruzioni, consulta la guida Gestire le origini dati API per i caricamenti dei prodotti.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-22 UTC.
[null,null,["Ultimo aggiornamento 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."]]
