products
pozwalają na dużą elastyczność i kontrolę
60 atrybutów produktów.Istnieje wiele wymaganych pól,
i muszą być uwzględnione, aby zostały zatwierdzone do wyświetlania w Zakupach Google.
Istnieje wiele pól opcjonalnych, które mogą być obowiązkowe ze względu na różne
warunki, takie jak lokalizacja, typ produktu, wersje produktu i produkt
pakiety. Więcej informacji o ponad 60 opcjonalnych parametrach, które można
skonfigurowane dla produktów znajdziesz w Danych o produktach
Specyfikacje.
Zasób products pozwala na insert, get, update i delete
oraz list wszystkie produkty w bazie danych Merchant Center.
productstatuses
można wykorzystać do sprawdzenia stanu zatwierdzenia lub odrzucenia konkretnej
produkt w miejscu docelowym. Zapoznaj się ze stanem produktu
, aby dowiedzieć się,
w przypadku produktów mogą występować problemy z jakością danych (jakie mogą się pojawić).
W przykładach z interfejsem API korzystamy z trzech produktów: dwóch koszulek Google i
Google: Korzystamy z minimalnej ilości danych produktów przedstawionych w tabeli poniżej,
wykonuj products wywołania zasobów, aby wstawiać, pobierać, aktualizować, wyświetlać i usuwać
poszczególnych produktów lub partii produktów.
Zalecamy skonfigurowanie informacji o wysyłce i podatkach na koncie na poziomie 3D, na poziomie produktu.
W przypadku subkont wielu sprzedawców
Platformy handlowe: wszystkie produkty muszą
dodaj pole external_seller_id. Zobacz
Identyfikatory produktów.
 |
 |
 |
|
| id | online:en:US:1111111111 | online:en:US:2222222222 | online:en:US:3333333333 |
| offerId | 1111111111 | 2222222222 | 3333333333 |
| tytuł | Czarna koszulka Google | Zielona koszulka Google | Czapka z daszkiem Google |
| opis | Czarna koszulka Google | Koszulka Google 100% bawełna | Klasyczna czapka z daszkiem Google |
| identyfikator grupy produktów | google_tee | google_tee | |
| link | http://my.site.com/blacktee | http://my.site.com/greentee | http://my.site.com/blackhat |
| stan | Nowość | Nowość | Nowość |
| cena | 21.99 PLN | 21.99 PLN | 10.99 PLN |
| dostępność | W magazynie | W magazynie | W magazynie |
| imageLink | https://shop.example.com/ |
https://shop.example.com/ |
https://shop.example.com/ |
| gtin | 9504000059422 | 9504000059446 | 9504000059452 |
| mpn | 00638NIC | 00638ANG | 00638ABC |
| marka | |||
| Kategoria produktów Google | Odzież Akcesoria > Odzież | Odzież Akcesoria > Odzież | Odzież Akcesoria > Akcesoria odzieżowe > Kapelusze |
| kolor | czarny | zielony | czarny |
| rozmiar | L | M | M |
| age_group | tylko dla dorosłych | tylko dla dorosłych | tylko dla dorosłych |
| płeć | mężczyźni | mężczyźni | uniseks |
| included_destination | Shopping Actions, reklamy produktowe | Shopping Actions, reklamy produktowe | Shopping Actions |
products.insert
Aby wstawić pojedynczy produkt, użyj poniższego adresu URL żądania, określając
identyfikator sprzedawcy i przykładową treść JSON. Wstawienie tworzy nowy produkt. Jeżeli wartości
dla atrybutów channel, contentLanguage, offerId i
feedLabel dla danego produktu, ta metoda aktualizuje ten wpis i zastępuje go
wszystkich danych z poprzednich wywołań interfejsu API dla danej usługi.
Produkty wykluczone ze wszystkich miejsc docelowych na dłużej niż 7 dni są usunięte automatycznie.
Pokazany przykład przedstawia nową „czarną koszulkę Google” do dostępnych usług.
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
Przykładowe wywołanie treści żądania dla elementu products.insert:
{
"kind": "content#product",
"offerId": "1111111111",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing.",
"link": "http://my.site.com/blacktee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531656",
"itemGroupId": "google_tee",
"mpn": "608802531656",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Large"
]
}
Produkt może też mieć ustawione atrybuty niestandardowe w treści JSON. Przykład:
możemy ustawić purchase_quantity_limit dla pojedynczego produktu, aby ograniczyć
liczba produktów, które klient może zamówić:
"customAttributes": [
{
"name": "purchase_quantity_limit",
"value": "4"
}
]
Pamiętaj, że atrybut niestandardowy purchase_quantity_limit ustawia limit zakupów
za zamówienie klienta zgodnie z definicją produktu. Jest również obsługiwana przez pliki danych.
jest obecnie w wersji beta, dopóki interfejs API nie będzie w pełni obsługiwany. Dowolne
sprzedawca może dodać dodatkowy atrybut niestandardowy, ale nie powoduje on:
za pomocą interfejsów API.
Udane wywołanie zwraca kod HTTP 200 i treść odpowiedzi zawierającą
wstawiony zasób produktu zawierający tylko wartości id, offerId, contentLanguage,
Wypełnione pola feedLabel i channel:
{
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online"
}
products.get
Aby uzyskać informacje o konkretnym produkcie z bazy danych Merchant Center, użyj funkcji
products.get Może minąć kilka minut, zanim nowo wstawiony produkt zostanie dodany
dostępnych w ramach tej rozmowy.
Użyj poniższego adresu URL i parametrów żądania HTTP, swojego identyfikatora sprzedawcy oraz identyfikator produktu (format identyfikatora REST) produktu, który chcesz otrzymać:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Udane wywołanie zwraca HTTP 200 i „zasób produktu” w
treść odpowiedzi. Oto przykładowe dane produktów pobrane z produktu o identyfikatorze
online:en:US:1111111111:
{
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"source": "api",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing.",
"link": "http://my.site.com/blacktee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531656",
"itemGroupId": "google_tee",
"mpn": "608802531656",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Large"
]
}
products.update
Aby zaktualizować pojedynczą usługę, użyj poniższego adresu URL żądania z metodą PATCH:
podając identyfikator sprzedawcy, identyfikator produktu oraz treść JSON zawierającą dane,
chcą wprowadzić zmiany w usłudze. W przeciwieństwie do zasady products.insert, która wymaga
wszystkie wymagane pola (products.update) wymaga tylko
określ pola, które chcesz zmienić.
Aby dodać lub zmodyfikować atrybut, podaj pole z nową wartością w pliku JSON
. Pokazany przykład spowoduje zaktualizowanie wartości title i description istniejącego
„Czarna koszulka z logo Google” z danymi produktu podanymi w treści żądania, pozostawiając
wszystkie pozostałe pola bez zmian.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Przykładowe wywołanie treści żądania dla elementu products.update:
{
"title": "Google Tee Black Limited Edition",
"description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}
Za pomocą żądania products.update można aktualizować tylko pola najwyższego poziomu.
Jeśli chcesz zaktualizować zagnieżdżone pola, musisz podać cały obiekt najwyższego poziomu.
Pokazany przykład spowoduje zaktualizowanie obiektu salePrice najwyższego poziomu, w tym
dotychczasowego produktu, przy czym dane produktu podane w sekcji
treści żądania, pozostawiając pozostałe pola bez zmian.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
{
"salePrice": {
"value": "17.99",
"currency": "USD"
}
}
Wybranie niektórych pól do aktualizacji bez wprowadzania zmian w pozostałych uwzględnionych polach
w treści żądania możesz określić updateMask. Ten ciąg zapytania
powinien być rozdzielaną przecinkami listą pól, które chcesz zmodyfikować.
updateMask przydaje się, gdy chcesz potwierdzić, że tylko nazwane pola
zostaną zaktualizowane. Nieokreślenie atrybutu updateMask jest równoważne z oznaczeniem wszystkich
w żądaniu aktualizacji, jak widać w powyższym przykładzie.
Pokazany przykład spowoduje zaktualizowanie tylko description i availability
istniejącej „czarnej koszulki z logo Google”, z odpowiednimi danymi produktu podanymi w dokumencie
treść żądania, pozostawiając wszystkie inne pola, w tym pole title, bez zmian.
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability
Przykładowe wywołanie treści żądania dla elementu products.update:
{
"title": "Google Tee Black",
"description": "This Limited Edition is out of print.",
"availability": "out of stock"
}
Jeśli pole jest określone na liście updateMask, ale nie ma go w treści żądania,
to pole zostanie usunięte z zasobu Product, jeśli istnieje.
W pokazanym przykładzie użyto updateMask do usunięcia wartości pola
salePrice
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice
Przykładowa treść żądania nie powinna zawierać pola salePrice, aby
Usuń. Możesz też nie podać żadnej treści lub może ona być pusta. Inne pola
pozostają niezmienione, o ile nie są widoczne w updateMask.
Aby użyć funkcji updateMask w żądaniu products.custombatch, updateMask
powinny być określone w treści żądania.
Pokazany przykład spowoduje zaktualizowanie wartości price i availability istniejącego
„Czarna koszulka z logo Google” używając atrybutu products.custombatch z podanymi danymi produktów
we wpisie zbiorczym, pozostawiając wszystkie inne pola, w tym title i description
niezakłócony.
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
{
"entries": [{
"batchId": 1,
"merchantId": "MERCHANT_ID",
"productId": "online:en:US:1111111111",
"method": "update",
"product": {
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing.",
"availability": "in stock",
"price": {
"value": "19.99",
"currency": "USD"
}
},
"updateMask": "availability,price"
}]
}
products.delete
Aby usunąć pojedynczy produkt, użyj polecenia products.delete z przykładowym żądaniem HTTP
adresu URL, identyfikatora sprzedawcy oraz identyfikatora produktu (w formacie identyfikatora REST, takiego jak
online:en:US:1111111111) w przypadku produktu, który chcesz usunąć:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
Odpowiedź pomyślna zwraca żądanie HTTP Status 204 bez treści odpowiedzi.
products.list
products.list zawiera listę wszystkich produktów, które sprzedawca ma w Merchant Center
w bazie danych. Użyj tego adresu URL żądania:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
Udane wywołanie zwraca dane HTTP 200 i JSON dla produktów w
„zasoby” .
Zwracane są te 3 przykładowe produkty:
{
"kind": "content#productsListResponse",
"resources": [
{
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"source": "api",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing.",
"link": "http://my.site.com/blacktee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531656",
"itemGroupId": "google_tee",
"mpn": "608802531656",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Large"
]
},
{
"kind": "content#product",
"id": "online:en:US:2222222222",
"offerId": "2222222222",
"source": "api",
"title": "Google Tee Green",
"description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
Features the google logo across the chest. Unisex sizing.",
"link": "http://my.site.com/greentee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "green",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531649",
"itemGroupId": "google_tee",
"mpn": "608802531649",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Medium"
]
},
{
"kind": "content#product",
"id": "online:en:US:3333333333",
"offerId": "3333333333",
"source": "api",
"title": "Google Twill Cap",
"description": "Classic urban styling distinguishes this Google cap.
Retains its shape, even when not being worn.",
"link": "http://my.site.com/blackhat/",
"imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-07T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "173",
"gtin": "689355417246",
"mpn": "689355417246",
"price": {
"value": "10.99",
"currency": "USD"
},
"sizes": [
"Medium"
]
}
]
}