Za pomocą interfejsu Merchant API możesz zarządzać lokalnym (w sklepie stacjonarnym) i regionalnym asortymentem.
Żądania
W przypadku Merchant Inventories API użyj tego formatu adresu URL żądania:
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/regionalInventories
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories
{PARENT} będzie mieć format: accounts/{ACCOUNT_ID}/products/ {PRODUCT_ID}.
Oto przykładowe porównanie żądań dotyczących asortymentu lokalnego:
| Element | Content API for Shopping | Merchant API |
|---|---|---|
| Adres URL | https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory | https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories |
| Identyfikatory | {MERCHANT_ID}/products/{PRODUCT_ID} |
{NAME}
|
Metody
Interfejs Merchant API wprowadza 2 nowe metody zarządzania asortymentem:
list: umożliwia wyświetlanie lokalnego i regionalnego asortymentu produktów.delete: umożliwia usunięcie lokalnego i regionalnego asortymentu produktów.
Poniżej znajdziesz porównanie dostępnych metod zarządzania zasobami reklamowymi:
| Metoda | Content API for Shopping | Merchant API |
|---|---|---|
customBatch |
Tak | Nie |
insert |
Tak | Tak |
list |
Nie | Tak |
delete |
Nie | Tak |
Zasoby
Co się zmieniło w przypadku lokalnych i regionalnych plików danych o asortymencie:
| Content API for Shopping | Merchant API | Opis |
|---|---|---|
| Nieobsługiwane | name:string
|
To pole rozróżnia zasoby LocalInventory i RegionalInventory w ramach product. Interfejs Content API for Shopping identyfikuje asortyment lokalny za pomocą symboli storeCode i productId, a asortyment regionalny za pomocą symboli regionId i productId.
|
| Nieobsługiwane | account:string
|
Dodaliśmy nowe pole, aby identyfikować konto Merchant Center, do którego należą product i LocalInventory.
|
price: {
object (Price)
}
|
price: {
|
Zmieniła się definicja Price.
|
salePrice: {
|
salePrice: {
|
Zmieniła się definicja Price.
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate używa nowego obiektu TimePeriod w interfejsie Merchant Inventories API.
|
kind:string
|
Nieobsługiwane | Interfejs API nie obsługuje kind.
|
quantity:string
|
quantity:integer
|
quantity w przypadku asortymentu lokalnego przyjmuje liczbę całkowitą zamiast ciągu znaków.
|
| Nieobsługiwane | localShippingLabel:string
|
Dodano nowe pole, aby identyfikować konto Merchant Center, do którego należą product i regionalInventory.
|
"regionId": string
|
"region": string
|
regionID to teraz region w przypadku regionalnych zasobów reklamowych.
|
string pola typu z określonym zestawem wartości,
|
enum pola typu z określonym zestawem wartości,
|
Pola w atrybutach asortymentu z określonym zestawem wartości (np. availability, pickupMethod) mają teraz typ enum.
|