Za pomocą Merchant API możesz zarządzać lokalnym (sklepowym) i regionalnym asortymentem.
Żądania
W przypadku żądań wysyłanych do podinterfejsu Inventories API używaj tego formatu adresu URL żądania:
POST https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/regionalInventories
W interfejsie Merchant API pod interfejsem API „inventories” i powiązanym punktem końcowym określa się w liczbie mnogiej jako „inventories”.
Oto przykładowe porównanie interfejsu Content API for Shopping z interfejsem Merchant Inventory API do żądań lokalnego asortymentu:
| Content API. | Interfejs API sprzedawcy | |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory | https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/localInventories |
| Identyfikatory | {MERCHANT_ID}/products/{PRODUCT_ID} |
{NAME}
|
Metody
Interfejs Merchant API udostępnia 2 nowe metody zarządzania zasobami reklamowymi:
- Wymień lokalne i regionalne asortymenty swoich produktów.
- Usuwanie lokalnego i regionalnego asortymentu z produktów
Oto porównanie metod dotyczących asortymentu w Content API for Shopping i interfejsie Merchant Inventories API:
| Metoda | Content API for Shopping | Interfejs API sprzedawcy |
|---|---|---|
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 sprzedawcy | Opis |
|---|---|---|
| Nieobsługiwane | name:string
|
Dodaliśmy nowe pole, aby odróżnić zasoby LocalInventory w ramach product. Interfejs Content API for Shopping identyfikuje lokalny asortyment za pomocą storeCode i productId.
|
| Nieobsługiwane | account:string
|
Dodano nowe pole, które identyfikuje konto sprzedawcy, do którego należą pola product i LocalInventory.
|
price: {
|
price: {
|
Zmieniła się definicja Price.
|
salePrice: {
|
salePrice: {
|
Zmieniła się definicja Price.
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate używa nowego typu TimePeriod w interfejsie Merchant Inventories API.
|
quantity:string,
|
quantity:integer
|
W interfejsie Merchant Inventories API parametr 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
|
Dodano nowe pole do etykietowania usług dostawy lokalnej w interfejsie Merchant Inventories API. |
Asortyment regionalny
Oto, co się zmieniło w przypadku zasobów reklamowych regionalnych w interfejsie Merchant Inventories API:
| Content API for Shopping | Interfejs API sprzedawcy | Opis |
|---|---|---|
| Nieobsługiwane | name:string
|
Dodaliśmy nowe pole, aby odróżnić zasoby regionalInventory w product. Interfejs Content API for Shopping identyfikuje asortyment regionalny za pomocą regionId i productId.
|
| Nieobsługiwane | account:string
|
Dodano nowe pole, które umożliwia identyfikację konta sprzedawcy, do którego należą pola product i regionalInventory.
|
"regionId": string
|
"region": string
|
W interfejsie Merchant Inventories API parametr regionID jest wywoływany jako region.
|
price: {
|
price: {
|
Zmieniła się definicja Price.
|
salePrice: {
|
salePrice: {
|
Zmieniła się definicja Price.
|
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.
|