Za pomocą interfejsu Merchant API możesz zarządzać asortymentem lokalnym (w sklepie) i regionalnym.
Żądania
Na potrzeby podrzędnego interfejsu API zasobów reklamowych użyj tego formatu adresu URL żądania:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories
W interfejsie Merchant API podrzędny interfejs API zasobów reklamowych i powiązany punkt końcowy są nazywane liczbą mnogą, czyli „zasobami”.
Oto przykładowe porównanie Content API for Shopping z interfejsem Merchant Inventories API w przypadku żądań lokalnego asortymentu:
| Content API. | Interfejs API dla sprzedawców | |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}/localinventory | https://merchantapi.googleapis.com/inventories/v1beta/{parent}/localInventories |
| Identyfikatory | {merchantId}/products/{productId} |
{name}
|
Metody
Interfejs Merchant API wprowadza 2 nowe metody zarządzania asortymentem:
- Utwórz listę lokalnego i regionalnego asortymentu swoich produktów
- Usuń ze swoich produktów lokalny i regionalny asortyment
Oto porównanie metod dotyczących asortymentu w Content API for Shopping i Merchant Inventories API:
| Metoda | Content API for Shopping | Interfejs API dla sprzedawców |
|---|---|---|
customBatch |
Tak | Nie |
insert |
Tak | Tak |
list |
Nie | Tak |
delete |
Nie | Tak |
Lokalny asortyment
Oto, co się zmieniło w przypadku lokalnego asortymentu w interfejsie Merchant Inventories API:
| Content API for Shopping | Interfejs API dla sprzedawców | Opis |
|---|---|---|
| Nieobsługiwane | name:string
|
Dodano nowe pole w celu odróżnienia zasobów LocalInventory w obrębie typu product. Interfejs Content API for Shopping identyfikuje lokalny asortyment według tych kryteriów: storeCode i productId.
|
| Nieobsługiwane | account:string
|
Dodano nowe pole identyfikujące konto sprzedawcy, do którego należą product i LocalInventory.
|
price: {
|
price: {
|
Definicja elementu Price została zmieniona.
|
salePrice: {
|
salePrice: {
|
Definicja elementu Price została zmieniona.
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate używa nowego typu TimePeriod w interfejsie Merchant Inventories API.
|
quantity:string,
|
quantity:integer
|
W interfejsie Merchant Inventories API funkcja quantity przyjmuje liczbę całkowitą zamiast ciągu znaków.
|
kind:string
|
Nieobsługiwane | Interfejs kind nie jest obsługiwany w interfejsie Merchant Inventories API.
|
| Nieobsługiwane | localShippingLabel:string
|
Dodaliśmy nowe pole, aby oznaczyć lokalne usługi dostawy w interfejsie Merchant Inventories API. |
Asortyment regionalny
Oto, co się zmieniło w przypadku asortymentu regionalnego w interfejsie Merchant Inventories API:
| Content API for Shopping | Interfejs API dla sprzedawców | Opis |
|---|---|---|
| Nieobsługiwane | name:string
|
Dodano nowe pole w celu odróżnienia zasobów regionalInventory w obrębie typu product. Interfejs Content API for Shopping identyfikuje regionalny asortyment według tych kryteriów: regionId i productId.
|
| Nieobsługiwane | account:string
|
Dodano nowe pole identyfikujące konto sprzedawcy, do którego należą product i regionalInventory.
|
"regionId": string
|
"region": string
|
W interfejsie Merchant Inventories API regionID ma nazwę region.
|
price: {
|
price: {
|
Definicja elementu Price została zmieniona.
|
salePrice: {
|
salePrice: {
|
Definicja elementu Price została zmieniona.
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate używa nowego typu TimePeriod w interfejsie Merchant Inventories API.
|
kind:string
|
Nieobsługiwane | Interfejs kind nie jest obsługiwany w interfejsie Merchant Inventories API.
|