Package google.shopping.merchant.inventories.v1beta

Indeks

LocalInventoryService

Usługa do zarządzania lokalnym asortymentem produktów

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

Usuwa określony atrybut LocalInventory z danego produktu na koncie sprzedawcy. Usunięcie LocalInventory z określonego produktu może potrwać do godziny. Po otrzymaniu odpowiedzi o udanym usunięciu zaczekaj do tego czasu, zanim spróbujesz usunąć plik ponownie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w OAuth 2.0 Overview.

InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

Wstawia zasób LocalInventory do produktu na koncie sprzedawcy.

Zastępuje pełny zasób LocalInventory, jeśli dla produktu istnieje już wpis o tym samym storeCode.

Zanim nowy lub zaktualizowany zasób LocalInventory pojawi się w produktach, może minąć do 30 minut.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w OAuth 2.0 Overview.

ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

Wyświetla zasoby LocalInventory dla danego produktu na koncie sprzedawcy. Odpowiedź może zawierać mniej elementów niż określono w parametry pageSize. Jeśli pageToken zostało zwrócone w poprzednim żądaniu, można go użyć do uzyskania dodatkowych wyników.

LocalInventory zasobów są wymienione w przypadku każdego produktu na danym koncie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w OAuth 2.0 Overview.

RegionalInventoryService

Usługa do zarządzania regionalnym asortymentem produktów. Do zarządzania definicjami regionów służy też osobny zasób regions i interfejs API.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Usuwa określony zasób RegionalInventory z danego produktu na koncie sprzedawcy. Usunięcie RegionalInventory z określonej usługi może potrwać do godziny. Po otrzymaniu odpowiedzi o udanym usunięciu zaczekaj do tego czasu, zanim spróbujesz usunąć plik ponownie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w OAuth 2.0 Overview.

InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

Wstawia RegionalInventory do danego produktu na koncie sprzedawcy.

Zastępuje pełny zasób RegionalInventory, jeśli dla produktu istnieje już wpis o tym samym region.

Zanim nowy lub zaktualizowany zasób RegionalInventory pojawi się w produktach, może minąć do 30 minut.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w OAuth 2.0 Overview.

ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

Wyświetla zasoby RegionalInventory dla danego produktu na koncie sprzedawcy. Odpowiedź może zawierać mniej elementów niż określono w parametry pageSize. Jeśli pageToken zostało zwrócone w poprzednim żądaniu, można go użyć do uzyskania dodatkowych wyników.

RegionalInventory zasobów są wymienione w przypadku każdego produktu na danym koncie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w OAuth 2.0 Overview.

DeleteLocalInventoryRequest

Żądanie wiadomości dla metody DeleteLocalInventory.

Pola
name

string

Wymagane. Nazwa lokalnego asortymentu danego produktu, który chcesz usunąć. Format: accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

Żądanie wiadomości dla metody DeleteRegionalInventory.

Pola
name

string

Wymagane. Nazwa zasobu RegionalInventory, który chcesz usunąć. Format: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

Żądanie wiadomości dla metody InsertLocalInventory.

Pola
parent

string

Wymagane. Konto i produkt, w których zostanie wstawiony ten asortyment. Format: accounts/{account}/products/{product}

local_inventory

LocalInventory

Wymagane. informacje o lokalnym asortymencie produktu, Jeśli produkt ma już zasób LocalInventory dla tego samego storeCode, następuje całkowite zastąpienie zasobu LocalInventory.

InsertRegionalInventoryRequest

Żądanie wiadomości dla metody InsertRegionalInventory.

Pola
parent

string

Wymagane. Konto i produkt, w których zostanie wstawiony ten asortyment. Format: accounts/{account}/products/{product}

regional_inventory

RegionalInventory

Wymagane. informacje o asortymencie regionalnym, które chcesz dodać do produktu. Jeśli produkt ma już zasób RegionalInventory dla tego samego region, następuje całkowite zastąpienie zasobu RegionalInventory.

ListLocalInventoriesRequest

Żądanie wiadomości dla metody ListLocalInventories.

Pola
parent

string

Wymagane. name produktu nadrzędnego, dla którego chcesz podać lokalne asortymenty. Format: accounts/{account}/products/{product}

page_size

int32

Maksymalna liczba zasobów LocalInventory danego produktu, które można zwrócić. Jeśli liczba elementów w magazynie danego produktu jest mniejsza niż pageSize, usługa zwraca mniejszą wartość. Wartością domyślną jest 25000. Maksymalna wartość to 25 000. Jeśli zostanie podana wyższa wartość, pageSize zostanie domyślnie ustawiona na maksimum.

page_token

string

Token strony otrzymany z poprzedniego wywołania funkcji ListLocalInventories. Podaj token strony, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry przekazywane do funkcji ListLocalInventories muszą być zgodne z wywołaniem, które dostarczyło token strony. Token zwrócony jako nextPageToken w odpowiedzi na poprzednie żądanie.

ListLocalInventoriesResponse

wiadomość z odpowiedzią dla metody ListLocalInventories.

Pola
local_inventories[]

LocalInventory

LocalInventory zasobów danej usługi na określonym koncie.

next_page_token

string

token, który może być wysyłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListRegionalInventoriesRequest

Żądanie wiadomości dla metody ListRegionalInventories.

Pola
parent

string

Wymagane. name usługi nadrzędnej, dla której chcesz wyświetlić listę zasobów RegionalInventory. Format: accounts/{account}/products/{product}

page_size

int32

Maksymalna liczba zasobów RegionalInventory danego produktu, które można zwrócić. Jeśli liczba elementów w magazynie danego produktu jest mniejsza niż pageSize, usługa zwraca mniejszą wartość. Wartością domyślną jest 25000. Maksymalna wartość to 100 000. Jeśli zostanie podana wyższa wartość, pageSize zostanie domyślnie ustawiona na maksimum.

page_token

string

Token strony otrzymany z poprzedniego wywołania funkcji ListRegionalInventories. Podaj token strony, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry przekazywane do funkcji ListRegionalInventories muszą być zgodne z wywołaniem, które dostarczyło token strony. Token zwrócony jako nextPageToken w odpowiedzi na poprzednie żądanie.

ListRegionalInventoriesResponse

wiadomość z odpowiedzią dla metody ListRegionalInventories.

Pola
regional_inventories[]

RegionalInventory

RegionalInventory zasobów danej usługi na określonym koncie.

next_page_token

string

token, który może być wysyłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

LocalInventory

informacje o lokalnym asortymencie produktu, Reprezentuje informacje o konkretnym produkcie w sklepie określonym przez storeCode. Listę wszystkich akceptowanych wartości atrybutów znajdziesz w specyfikacji danych o asortymencie produktów dostępnych lokalnie.

Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu LocalInventory. Format: accounts/{account}/products/{product}/localInventories/{store_code}

account

int64

Tylko dane wyjściowe. Konto, do którego należy produkt. To pole zostanie zignorowane, jeśli zostanie ustawione przez klienta.

store_code

string

Wymagane. Niezmienna. Kod sklepu (identyfikator sklepu z profilu firmy) sklepu fizycznego, w którym sprzedawany jest produkt. Więcej informacji znajdziesz w specyfikacji danych o asortymencie produktów dostępnych lokalnie.

price

Price

Cena produktu w tym sklepie.

sale_price

Price

Cena promocyjna produktu w tym sklepie. Wymagana, jeśli zdefiniowano właściwość salePriceEffectiveDate.

sale_price_effective_date

Interval

TimePeriod w tym sklepie.

custom_attributes[]

CustomAttribute

Lista atrybutów niestandardowych (podanych przez sprzedawcę). Możesz też użyć atrybutu CustomAttribute, aby przesłać dowolny atrybut specyfikacji danych w formie ogólnej.

availability

string

Dostępność produktu w tym sklepie. Informacje o akceptowanych wartościach atrybutów znajdziesz w specyfikacji danych o asortymencie produktów dostępnych lokalnie.

quantity

int64

Liczba sztuk produktu dostępnych w tym sklepie. Musi być równa lub większa niż 0.

pickup_method

string

Obsługiwana metoda odbioru tego produktu. Jeśli wartość nie jest "not supported", to pole musi być przesłane razem z polem pickupSla. Informacje o akceptowanych wartościach atrybutów znajdziesz w specyfikacji danych o asortymencie produktów dostępnych lokalnie.

pickup_sla

string

Odległość w czasie od daty złożenia zamówienia na dany produkt w danym sklepie do daty, kiedy będzie ono gotowe do odbioru. Musi być przesłany z pickupMethod. Informacje o akceptowanych wartościach atrybutów znajdziesz w specyfikacji danych o asortymencie produktów dostępnych lokalnie.

instore_product_location

string

lokalizacja produktu w sklepie; Maksymalna długość to 20 bajtów.

RegionalInventory

informacje o regionalnym asortymencie produktu, Reprezentuje konkretne informacje, takie jak cena i dostępność danego produktu w określonym region. Listę wszystkich akceptowanych wartości atrybutów znajdziesz w specyfikacji danych o asortymencie produktów regionalnych.

Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu RegionalInventory. Format: {regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}

account

int64

Tylko dane wyjściowe. Konto, do którego należy produkt. To pole zostanie zignorowane, jeśli zostanie ustawione przez klienta.

region

string

Wymagane. Niezmienna. Identyfikator regionu zasobu RegionalInventory. Więcej informacji znajdziesz w artykule Regionalna dostępność i ceny.

price

Price

Cena produktu w tym regionie.

sale_price

Price

Cena promocyjna produktu w tym regionie. Wymagana, jeśli zdefiniowano właściwość salePriceEffectiveDate.

sale_price_effective_date

Interval

TimePeriod ceny promocyjnej w tym regionie.

custom_attributes[]

CustomAttribute

Lista atrybutów niestandardowych (podanych przez sprzedawcę). Możesz też użyć atrybutu CustomAttribute, aby przesłać dowolny atrybut specyfikacji danych w formie ogólnej.

availability

string

Dostępność produktu w tym regionie. Akceptowane wartości atrybutów znajdziesz w specyfikacji danych o asortymencie produktów regionalnych.