Package google.shopping.merchant.inventories.v1beta

Indeks

LocalInventoryService

Usługa zarządzania lokalnym asortymentem produktów

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

Usuwa określony atrybut LocalInventory z danego produktu na Twoim koncie sprzedawcy. Usunięcie elementu LocalInventory z konkretnej usługi może potrwać do godziny. Po otrzymaniu odpowiedzi o pomyślnym usunięciu danych odczekaj ten okres, zanim spróbujesz ponownie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.
InsertLocalInventory

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

Wstawia zasób LocalInventory do produktu na Twoim koncie sprzedawcy.

Zastępuje pełny zasób LocalInventory, jeśli dla produktu istnieje już wpis z taką samą wartością storeCode.

Może minąć do 30 minut, zanim nowy lub zaktualizowany zasób LocalInventory pojawi się w usługach.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.
ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

Wyświetla listę zasobów LocalInventory dotyczących danego produktu na Twoim koncie sprzedawcy. Odpowiedź może zawierać mniej elementów niż określono w zasadzie pageSize. Jeśli w poprzednim żądaniu została zwrócona funkcja pageToken, można jej użyć do uzyskania dodatkowych wyników.

Lista zasobów (LocalInventory) dla każdej usługi na danym koncie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

RegionalInventoryService

Usługa zarządzania regionalnym asortymentem produktów. Dostępne są też osobne zasoby i interfejsy API regions do zarządzania definicjami regionów.

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

Usuwa określony zasób RegionalInventory z danego produktu na Twoim koncie sprzedawcy. Usunięcie elementu RegionalInventory z konkretnej usługi może potrwać do godziny. Po otrzymaniu odpowiedzi o pomyślnym usunięciu danych odczekaj ten okres, zanim spróbujesz ponownie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.
InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

Wstawia atrybut RegionalInventory do danego produktu na Twoim koncie sprzedawcy.

Zastępuje pełny zasób RegionalInventory, jeśli dla produktu istnieje już wpis z taką samą wartością region.

Może minąć do 30 minut, zanim nowy lub zaktualizowany zasób RegionalInventory pojawi się w usługach.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.
ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

Wyświetla listę zasobów RegionalInventory dotyczących danego produktu na Twoim koncie sprzedawcy. Odpowiedź może zawierać mniej elementów niż określono w zasadzie pageSize. Jeśli w poprzednim żądaniu została zwrócona funkcja pageToken, można jej użyć do uzyskania dodatkowych wyników.

Lista zasobów (RegionalInventory) dla każdej usługi na danym koncie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

DeleteLocalInventoryRequest

Prośba o wiadomość dla metody DeleteLocalInventory.

Pola
name

string

Wymagane. Nazwa lokalnego asortymentu produktów do usunięcia. Format: accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

Prośba o wiadomość dla metody DeleteRegionalInventory.

Pola
name

string

Wymagane. Nazwa zasobu RegionalInventory do usunięcia. Format: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

Prośba o wiadomość dla metody InsertLocalInventory.

Pola
parent

string

Wymagane. Konto i produkt, do których zostaną wstawione 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 zasobu (storeCode), wykonywany jest pełny zastąpienie zasobu LocalInventory.

InsertRegionalInventoryRequest

Prośba o wiadomość dla metody InsertRegionalInventory.

Pola
parent

string

Wymagane. Konto i produkt, do których zostaną wstawione ten asortyment. Format: accounts/{account}/products/{product}
regional_inventory

RegionalInventory

Wymagane. Informacje o regionalnym asortymencie, które chcesz dodać do produktu. Jeśli produkt ma już zasób RegionalInventory dla tego samego zasobu (region), wykonywany jest pełny zastąpienie zasobu RegionalInventory.

ListLocalInventoriesRequest

Prośba o wiadomość dla metody ListLocalInventories.

Pola
parent

string

Wymagane. Wartość name produktu nadrzędnego, dla którego ma być wyświetlana lista lokalnego asortymentu. Format: accounts/{account}/products/{product}
page_size

int32

Maksymalna liczba zasobów LocalInventory, które dany produkt może zwrócić. Usługa zwraca mniej od tej wartości, jeśli liczba asortymentu w przypadku danego produktu jest mniejsza niż wartość pageSize. Wartość domyślna to 25 000. Maksymalna wartość to 25 000. Jeśli zostanie określona wartość większa niż maksymalna, pageSize domyślnie ustawi wartość maksymalną.
page_token

string

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

W przypadku podziału na strony wszystkie pozostałe parametry podane w interfejsie ListLocalInventories muszą odpowiadać wywołaniu, które podało token strony. Token zwrócony jako nextPageToken w odpowiedzi na poprzednie żądanie.

ListLocalInventoriesResponse

Wiadomość z odpowiedzią dla metody ListLocalInventories.

Pola
local_inventories[]

LocalInventory

Zasoby LocalInventory danego produktu z podanego konta.
next_page_token

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListRegionalInventoriesRequest

Prośba o wiadomość dla metody ListRegionalInventories.

Pola
parent

string

Wymagane. Pole name usługi nadrzędnej, dla której ma zostać wyświetlona lista zasobów RegionalInventory. Format: accounts/{account}/products/{product}
page_size

int32

Maksymalna liczba zasobów RegionalInventory, które dany produkt może zwrócić. Usługa zwraca mniej od tej wartości, jeśli liczba asortymentu w przypadku danego produktu jest mniejsza niż wartość pageSize. Wartość domyślna to 25 000. Maksymalna wartość to 100 000. Jeśli zostanie określona wartość wyższa niż maksymalna, pageSize domyślnie przyjmuje wartość maksymalną.
page_token

string

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

W przypadku podziału na strony wszystkie pozostałe parametry podane w interfejsie ListRegionalInventories muszą odpowiadać wywołaniu, które podało token strony. Token zwrócony jako nextPageToken w odpowiedzi na poprzednie żądanie.

ListRegionalInventoriesResponse

Wiadomość z odpowiedzią dla metody ListRegionalInventories.

Pola
regional_inventories[]

RegionalInventory

Zasoby RegionalInventory danego produktu z podanego konta.
next_page_token

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

LocalInventory

Informacje o lokalnym asortymencie produktu. Reprezentuje informacje o sklepie dotyczącym konkretnego produktu w sklepie określonym przez atrybut storeCode. Listę wszystkich akceptowanych wartości atrybutów znajdziesz w specyfikacji danych lokalnego asortymentu produktów.

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. Jeśli pole zostanie ustawione przez klienta, będzie ignorowane.
store_code

string

Wymagane. Stałe. Kod sklepu (identyfikator sklepu widoczny w profilu Twojej firmy) sklepu stacjonarnego, w którym sprzedawany jest produkt. Więcej informacji znajdziesz w specyfikacji danych lokalnego asortymentu produktów.
price

Price

Cena produktu w tym sklepie.
sale_price

Price

Cena promocyjna produktu w tym sklepie. Wymagane, jeśli zdefiniowano salePriceEffectiveDate.
sale_price_effective_date

Interval

TimePeriod sprzedaży w tym sklepie.
custom_attributes[]

CustomAttribute

Lista atrybutów niestandardowych (dostarczanych 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. Akceptowane wartości atrybutów znajdziesz w specyfikacji danych lokalnego asortymentu produktów.
quantity

int64

Liczba sztuk produktu dostępnych w tym sklepie. Wartość nie może być mniejsza niż 0.
pickup_method

string

Obsługiwana metoda odbioru w przypadku tego produktu. Jeśli wartością nie jest "not supported", to pole należy przesłać razem z wartością pickupSla. Akceptowane wartości atrybutów znajdziesz w specyfikacji danych lokalnego asortymentu produktów.
pickup_sla

string

Względny okres od daty zamówienia, przez jaki zamówienie na ten produkt z tego sklepu będzie gotowe do odbioru. Należy ją przesłać za pomocą pickupMethod. Akceptowane wartości atrybutów znajdziesz w specyfikacji danych lokalnego asortymentu produktów.
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 atrybucie region. Listę wszystkich akceptowanych wartości atrybutów znajdziesz w specyfikacji danych regionalnego asortymentu produktów.

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. Jeśli pole zostanie ustawione przez klienta, będzie ignorowane.
region

string

Wymagane. Stałe. Identyfikator regionu tego 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. Wymagane, jeśli zdefiniowano salePriceEffectiveDate.
sale_price_effective_date

Interval

TimePeriod ceny promocyjnej w tym regionie.
custom_attributes[]

CustomAttribute

Lista atrybutów niestandardowych (dostarczanych 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 regionalnego asortymentu produktów.