Esegui la migrazione della gestione dei prodotti

Puoi utilizzare l'API Merchant per caricare e gestire i tuoi prodotti in modo programmatico. La risorsa accounts.products ti consente di creare un catalogo del negozio online, ovvero un elenco di prodotti e offerte. Per saperne di più sul caricamento e sulla gestione dei prodotti tramite l'API Merchant, consulta la Panoramica dell'API Merchant Products.

Modifiche alle risorse

Le risorse products e productstatuses dell'API Content vengono sostituite dalle risorse productInputs e products.

Puoi utilizzare la risorsa productInputs dell'API Merchant per caricare le informazioni sui prodotti. La risorsa product dell'API Merchant può essere utilizzata per recuperare i prodotti elaborati, inclusi gli stati.

Requisito dell'origine dati

Nell'API Merchant, devi specificare l'origine dati di destinazione quando carichi i prodotti. Può essere un'origine dati principale o un'origine dati supplementare. Puoi recuperare le origini dati esistenti utilizzando dataSources.list o creare una nuova origine dati utilizzando dataSources.create.

In alternativa, puoi utilizzare l'interfaccia utente di Merchant Center per gestire le tue origini dati.

Per saperne di più sulle origini dati e su come crearle e gestirle, consulta la Panoramica dell'API Merchant Data Sources.

Modifiche all'identificatore

L'API Merchant utilizza name per identificare il prodotto. Il nome del prodotto seguirà il formato accounts/{account}/products/{product}, dove {product} ha il formato channel~language~feedLabel~offerId.

Le risorse dell'API Content utilizzavano : anziché ~ tra ogni valore dell'ID: channel:language:feedLabel:offerId.

Tutte le chiamate all'API Merchant restituiscono il nuovo formato con ~ tra i valori dell'ID. Ti consigliamo di memorizzare il nuovo campo name dalla risposta e di utilizzarlo nelle chiamate future.

Metodi

Di seguito è riportato un confronto dei metodi dei prodotti nell'API Content for Shopping e nell'API Merchant Products:

API Content per Shopping	API Merchant Products
products.custombatch	Non disponibile
products.insert	productInputs.insert
products.update	Non ancora disponibile
products.delete	productInputs.delete
products.get	products.get
products.list	products.list
productstatuses.custombatch	Non disponibile
productstatuses.get	products.get
productstatuses.list	products.list

Richieste

Metodo API Content	URL nell'API Content for Shopping	URL nell'API Merchant Products	Identificatore nell'API Content	Identificatore nell'API Merchant Products
products.insert	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products	POST https://merchantapi.googleapis.com/products/v1beta/{PARENT}/productsInputs:insert?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID}	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}
products.update	PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	Non disponibile
products.delete	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	DELETE https://merchantapi.googleapis.com/products/v1beta/{NAME}?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID}	MERCHANT_ID, PRODUCT_ID	NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES}
products.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}	MERCHANT_ID, PRODUCT_ID	NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
products.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}
productstatuses.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}	MERCHANT_ID, PRODUCT_ID	NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
productstatuses.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}