rocket
Meet
API Merchant
- the official successor to the Content API for Shopping.
updateRicevi gli ultimi aggiornamenti
su nuove funzionalità, correzioni di bug e aggiornamenti delle release dell'API Merchant.
point_of_sale
Scopri come gestire la tua attività e i tuoi prodotti su Google e come ottenere l'accesso programmatico a
dati, approfondimenti e funzionalità uniche su larga scala.
Inizia a utilizzare l'API Merchant oggi stesso.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Riepilogo
Gli account Merchant Center memorizzano le informazioni sui prodotti per le campagne Shopping.
Puoi caricare le informazioni sui prodotti nel tuo account commerciante tramite i feed dei prodotti.
Puoi creare feed dei prodotti che caricano più prodotti contemporaneamente in Merchant Center o tramite l'API Content for Shopping. La Content API for Shopping ti consente anche di caricare e aggiornare i singoli prodotti.
Sia con i caricamenti di feed che di API, i prodotti appena caricati sono soggetti a controlli sulla qualità dei dati, la cui risoluzione può richiedere fino a 72 ore. Nel frattempo, questi prodotti avranno lo stato pending. Consulta la pagina Definizioni dello stato dei prodotti per ulteriori informazioni.
Se hai già informazioni sui prodotti su una piattaforma di e-commerce, potresti riuscire a collegare la piattaforma a Merchant Center e condividere automaticamente le informazioni. Rivolgiti al fornitore della tua piattaforma di e-commerce per sapere se esistono connettori per la condivisione delle informazioni sui prodotti con Merchant Center.
Tutti i prodotti devono rispettare la specifica dei dati di prodotto. Leggi attentamente la specifica per capire quali attributi del prodotto devono essere forniti affinché un prodotto sia valido. Alcuni tipi di prodotti richiedono attributi
diversi rispetto ad altri.
Passaggi manuali
Se questo è il caso della prima volta che crei un feed, potrebbero essere necessari alcuni tentativi per risolvere tutti gli errori. Per assistenza, visita la Community degli inserzionisti Google.
Puoi utilizzare l'API Content for Shopping per caricare collettivamente le informazioni sui prodotti
tramite feed e inviare informazioni sui singoli prodotti.
Puoi automatizzare solo i feed pianificati.
Utilizza il servizio datafeeds per creare, aggiornare ed eliminare i feed registrati.
Utilizza la risorsa products per caricare e aggiornare i singoli prodotti.
Utilizza products.insert per caricare le informazioni sul prodotto. Se invii più prodotti contemporaneamente, consulta la sezione Inviare richieste batch.
Gli errori dei prodotti vengono segnalati con un messaggio di stato HTTP non 2xx e il corpo della risposta contiene ulteriori informazioni.
Anche i prodotti caricati correttamente potrebbero restituire avvisi da esaminare per migliorare i dati. Per ulteriori informazioni, consulta la guida sugli errori comuni.
Puoi utilizzare il servizio productstatuses per visualizzare lo stato dei prodotti nel tuo account.
I singoli prodotti caricati tramite l'API Content for Shopping scadono dopo 30 giorni o alla data di scadenza impostata manualmente, a seconda dell'evento che si verifica per primo.
Per evitare che i prodotti scadano, i prodotti devono essere aggiornati o reinseriti. È importante programmare un aggiornamento periodico dell'endpoint
dell'API Content for Shopping products.
[null,null,["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eMerchant Center accounts store product information for Shopping campaigns, which is uploaded via product feeds or the Content API.\u003c/p\u003e\n"],["\u003cp\u003eGoogle strongly recommends using the Content API for Shopping for its flexibility and scalability over manual feed uploads.\u003c/p\u003e\n"],["\u003cp\u003eProducts uploaded through any method undergo data quality checks and may take up to 72 hours to resolve before becoming active.\u003c/p\u003e\n"],["\u003cp\u003eAll products must adhere to the Product data specification, which outlines the required attributes for different product types.\u003c/p\u003e\n"],["\u003cp\u003eThe Content API for Shopping offers methods for bulk uploads via feeds and individual product updates, requiring regular refreshes to prevent product expiration.\u003c/p\u003e\n"]]],[],null,["# Create a feed\n\nSummary\n-------\n\nMerchant Center accounts store the product information for Shopping campaigns.\nYou upload product information to your merchant account through product feeds.\nYou can create product feeds that upload multiple products at a time in\nthe [Merchant Center](https://merchants.google.com) or through the [Content API for Shopping](/shopping-content/guides/products/products-api). The Content API\nfor Shopping also lets you upload and update individual products.\n| **Objective:** We strongly recommend you use the Content API for Shopping. The Content API is much more flexible and scalable than the manual steps.\n\nWith both feed and API uploads, newly uploaded products are subject to data\nquality checks that may take up to 72 hours to resolve. These products will have\nthe `pending` status in the meantime. See the [Product status definitions](//support.google.com/merchants/answer/160491) page\nto learn more.\n\nIf you already have product information in an eCommerce platform, you may be\nable to connect that eCommerce platform to the Merchant Center and have the\ninformation shared automatically. Check with your eCommerce platform provider to\nsee if any connectors exist for sharing product information with the Merchant\nCenter.\n\nAll products must adhere to the [Product data specification](//support.google.com/merchants/answer/188494). Read\nthrough the specification to understand what product attributes must be provided\nfor a product to be valid. Some types of products require different attributes\nthan others.\n\nManual steps\n------------\n\nIf this if your first time creating a feed, it may take a few tries to\nresolve all the errors. See the [Google Advertiser Community](//www.en.advertisercommunity.com/t5/Google-Shopping-and-Merchant/bd-p/google-shopping) for help.\n\n1. See [About feeds](//support.google.com/merchants/answer/188478) and [File formats for product data](//support.google.com/merchants/answer/160567) to plan the structure of your feed.\n2. Follow the steps in [Upload a feed](//support.google.com/merchants/answer/188477).\n\nAutomatic steps\n---------------\n\nYou can use the Content API for Shopping to bulk upload product information\nthrough feeds and to send individual product information.\n\nYou can only automate scheduled feeds.\n\n- Use the [`datafeeds`](/shopping-content/reference/rest/v2.1/datafeeds) service to create, update, and delete registered feeds.\n- Use the [`products`](/shopping-content/reference/rest/v2.1/products) resource to upload and update individual products.\n\n See the [Product data specification](//support.google.com/merchants/answer/188494) to learn which fields are required\n for your specific product.\n\n Use [`products.insert`](/shopping-content/reference/rest/v2.1/products/insert) to upload product information. If you're sending\n multiple products at once, see [Sending batch requests](/shopping-content/guides/how-tos/batch).\n\n Product errors are signaled with a non-2xx HTTP status message, and\n the body of the response contains more information.\n\n Even successfully uploaded products may return warnings that you\n should examine to improve your proudct data. See the [common errors](/shopping-content/guides/how-tos/common-errors) guide\n for more information.\n\n You can use the [`productstatuses`](/shopping-content/reference/rest/v2.1/productstatuses) service to see the status of products on\n you account.\n\n Individual products uploaded through the Content API for Shopping\n expire either after 30 days or on their manually set expiration date,\n whichever comes first.\n\n In order to keep products from expiring, they must be updated or\n re-inserted. It's important to schedule a regularly occurring refresh to the\n Content API for Shopping's [`products`](/shopping-content/reference/rest/v2.1/products) endpoint."]]
