Za pomocą dodatkowych plików danych możesz częściowo zaktualizować dane produktów poprzez dodanie
feedId
jako parametru zapytania przy wywołaniach funkcji
products.insert
,
products.delete
,
products.custombatch.insert
oraz
products.custombatch.delete
.
Możesz na przykład wywołać metodę products.insert
dodatkowego pliku danych do
ten adres URL:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
products.insert
Metoda products.insert
w dodatkowym pliku danych dodaje pola produktów, które przesyłasz
w treści żądania, zastępując te pola, jeśli istnieją. Jeśli używasz tagu
dodatkowego pliku danych, ta metoda pozostawia wszystkie pozostałe pola produktu bez zmian,
były uwzględnione w poprzedniej prośbie dotyczącej tego samego pliku danych. Dane
dodane za pomocą innych plików danych, każde żądanie nadpisze poprzednie.
dotyczące tego samego kanału. Oznacza to, że jeśli dodasz lub zaktualizujesz pole za pomocą
i nie dodawaj tego pola do kolejnego żądania dodatkowego pliku danych
dane dla pominiętego pola zostaną usunięte z pliku danych. To zachowanie
różni się od wywoływania funkcji products.insert
bez dodatkowego pliku danych,
usuwa wszystkie istniejące dane produktów i zastępuje je polami przesłanymi w
treść żądania.
Użyj tego adresu URL, aby przesłać prośbę o dodatkowy plik danych
Usługa Product.insert
:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId
Musisz uwzględnić offerId
, feedLabel
, channel
i
contentLanguage
w treści żądania. Wszystkie pozostałe pola są opcjonalne.
Przykład
Aby zmienić dostępność produktu z „w magazynie” na „niedostępny”, musisz:
można użyć poniższego treści żądania, aby utworzyć dodatkowe pliki danych
Wywołanie metody Product.insert
:
{
"offerId": "1111111111",
"contentLanguage": "en",
"feedLabel": "US",
"channel": "online",
"availability": "out of stock",
}
products.delete
Metoda products.delete
usuwa wszystkie dodatkowe dane, które zostały
wcześniej dodane przez products.insert
wywołania za pomocą określonego uzupełniającego
kanału. Wywołanie tej metody w celu utworzenia dodatkowego pliku danych nie ma wpływu na oryginał.
dane produktów dodane przed wywołaniami Product.insert
dodatkowego pliku danych
podjętych działań. Można to wyobrazić sobie jako usuwanie warstwy danych z konkretnego pliku danych.
nie wpłynie na dane dodane za pomocą innych plików danych, a produkt
przywraca stan sprzed dodania warstwy dodatkowego pliku danych. Ten
różni się od wywoływania funkcji products.delete
bez dodatkowego pliku danych,
powoduje usunięcie całego produktu i wszystkich jego danych.
Użyj poniższego adresu URL, aby przesłać prośbę o dodatkowy plik danych products.delete
usługi, gdzie productId
to
Identyfikator REST
produktu reprezentowanego jako: channel:contentLanguage:feedLabel:offerId
:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId
Wywołania metody products.delete
w dodatkowych plikach danych nie wymagają treści żądania.
products.custombatch
Metody custombatch
umożliwiają przesłanie insert
lub delete
dodatkowego pliku danych
dla wielu produktów za pomocą jednego wywołania API w celu zminimalizowania liczby interfejsów API
wykonanych połączeń.
Aby wywołać funkcję custombatch
, użyj tego adresu URL żądania:
https://shoppingcontent.googleapis.com/content/v2.1/products/batch
W przypadku wszystkich wywołań funkcji custombatch
w dodatkowym pliku danych należy stosować parametry batchId
,
Parametry merchantID
, method
i feedId
w żądaniu
.
products.custombatch:insert
Jeśli odwołujesz się do metody products.custombatch:insert
za pomocą dodatkowego pliku danych,
musisz uwzględnić offerId
, feedLabel
, channel
oraz
contentLanguage
w treści żądania, oprócz wymaganych batchId
,
Parametry merchantID
i method
. Wszystkie pozostałe pola produktu są opcjonalne.
Przykład
Aby zaktualizować wartość price
w przypadku 2 istniejących produktów, możesz użyć polecenia
następujące żądanie, aby wywołać metodę 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
Aby usunąć wszystkie aktualizacje 2 produktów wprowadzone za pomocą określonego dodatkowego pliku danych:
można użyć poniższego żądania, aby utworzyć products.custombatch:delete
wywołanie metody:
{
"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"
}
]
}