Puoi utilizzare i feed supplementari per apportare aggiornamenti parziali ai dati di prodotto aggiungendo
feedId come parametro di query quando effettui chiamate al
products.insert,
products.delete,
products.custombatch.insert,
e
products.custombatch.delete
di machine learning.
Ad esempio, puoi effettuare una chiamata al metodo di feed supplementare products.insert a
al seguente URL:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
products.insert
Il metodo del feed supplementare products.insert aggiunge i campi di prodotto che invii
nel corpo della richiesta, sovrascrivendo questi campi, se presenti. Se utilizzi un
feed supplementare, questo metodo lascia invariati tutti gli altri campi del prodotto, a meno che
erano stati inclusi in una precedente richiesta per lo stesso feed. Mentre i dati
aggiunti tramite altri feed non è interessato, ogni richiesta sovrascrive la precedente
richieste per lo stesso feed. Ciò significa che se aggiungi o aggiorni un campo tramite una
richiesta di feed supplementare e non includere il campo in una successiva
richiesta, i dati per il campo omesso vengono rimossi dal feed. Questo comportamento
è diverso dalla chiamata di products.insert senza un feed supplementare,
elimina tutti i dati di prodotto esistenti e li sostituisce con i campi che invii
il corpo della richiesta.
Utilizza il seguente URL per inviare una richiesta al feed supplementare
Servizio Product.insert:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
Devi includere offerId, feedLabel, channel e
contentLanguage nel corpo della richiesta. Tutti gli altri campi sono facoltativi.
Esempio
Per modificare la disponibilità di un prodotto da "disponibile" a "non disponibile", devi
potresti utilizzare il seguente corpo della richiesta per creare un feed supplementare
Chiamata al metodo Product.insert:
{
"offerId": "1111111111",
"contentLanguage": "en",
"feedLabel": "US",
"channel": "online",
"availability": "out of stock",
}
products.delete
Il metodo products.delete rimuove tutti i dati aggiuntivi che erano
aggiunta in precedenza da products.insert chiamate utilizzando l'elemento supplementare specificato
feed. La chiamata di questo metodo per un feed supplementare non influisce sull'originale
dati di prodotto aggiunti prima dell'esecuzione di Product.insert chiamate del feed supplementare
in cui viene eseguito il deployment. È un po' come rimuovere un livello di dati per un feed specifico:
i dati aggiunti tramite altri feed non subiranno modifiche e il prodotto
torna allo stato precedente prima dell'aggiunta del livello del feed supplementare. Questo
è diverso dalla chiamata di products.delete senza un feed supplementare,
elimina l'intero prodotto e tutti i relativi dati.
Utilizza il seguente URL per inviare una richiesta del feed supplementare products.delete
servizio, dove productId è
ID REST
del prodotto, rappresentato come: channel:contentLanguage:feedLabel:offerId:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId
Per le chiamate al metodo products.delete dei feed supplementari non è necessario alcun corpo della richiesta.
products.custombatch
I metodi custombatch ti consentono di insert o delete feed supplementare
per più prodotti utilizzando una singola chiamata API per ridurre al minimo il numero
chiamate effettuate.
Usa il seguente URL di richiesta per effettuare una chiamata custombatch:
https://shoppingcontent.googleapis.com/content/v2.1/products/batch
Per tutte le chiamate a custombatch del feed supplementare, devi includere batchId,
Parametri merchantID, method e feedId nella richiesta
del testo.
products.custombatch:insert
Quando effettui chiamate di feed supplementari al metodo products.custombatch:insert,
devi includere offerId, feedLabel, channel e
contentLanguage nel corpo della richiesta, oltre al batchId obbligatorio,
Parametri merchantID e method. Tutti gli altri campi del prodotto sono facoltativi.
Esempio
Per aggiornare il valore price di due prodotti esistenti, puoi utilizzare il
seguente richiesta per effettuare una chiamata al metodo products.custombatch:insert:
{
"entries": [
{
"batchId": 1111,
"merchantId": 1234567,
"method": "insert",
"feedId": "7654321",
"product": {
"offerId": "1111111111",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"price": {
"value": "30.99",
"currency": "USD"
}
}
},
{
"batchId": 1112,
"merchantId": 1234567,
"method": "insert",
"feedId": "7654321",
"product": {
"offerId": "2222222222",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"price": {
"value": "33.99",
"currency": "USD"
},
},
}
}
products.custombatch:delete
Per rimuovere tutti gli aggiornamenti apportati a due prodotti tramite un feed supplementare specificato:
puoi utilizzare la seguente richiesta per effettuare un products.custombatch:delete
chiamata al metodo:
{
"entries": [
{
"batchId": 1115,
"merchantId": 1234567,
"method": "delete",
"feedId": "7654321",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1116,
"merchantId": 1234567,
"method": "delete",
"feedId": "7654321",
"productId": "online:en:US:2222222222"
}
]
}