Package google.shopping.merchant.lfp.v1beta

Indeks

LfpInventoryService

Usługa umożliwiająca partnerowi lokalnego asortymentu produktów przesyłanie lokalnego asortymentu sprzedawcy.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

Wstawia zasób LfpInventory dla podanego docelowego konta sprzedawcy. Jeśli zasób już istnieje, zostanie zastąpiony. Asortyment wygasa automatycznie po 30 dniach.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

LfpSaleService

Usługa dla partnera w programie partnerskim dotyczącym sprzedaży polegająca na przesyłaniu danych o sprzedaży sprzedawcy.

InsertLfpSale

rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale)

Wstawia LfpSale dla danego sprzedawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

LfpStoreService

Usługa dla partnera w programie LFP umożliwiająca przesyłanie lokalnych sklepów sprzedawcy.

DeleteLfpStore

rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty)

Usuwa sklep docelowego sprzedawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
GetLfpStore

rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore)

Pobiera informacje o sklepie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Wstawia sklep docelowego sprzedawcy. Jeśli sklep o tym samym kodzie już istnieje, zostanie zastąpiony.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Wyświetla sklepy docelowego sprzedawcy, określone przez filtr w sekcji ListLfpStoresRequest.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

DeleteLfpStoreRequest

Komunikat z prośbą o wykonanie metody DeleteLfpStore.

Pola
name

string

Wymagane. Nazwa sklepu, który chcesz usunąć z konta sprzedawcy docelowego. Format: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

Żądanie wiadomości dla metody GetLfpStore.

Pola
name

string

Wymagane. Nazwa sklepu do pobrania. Format: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

Żądanie wiadomości dla metody InsertLfpInventory.

Pola
parent

string

Wymagane. Konto dostawcy danych o asortymencie lokalnym. Format: accounts/{account}
lfp_inventory

LfpInventory

Wymagane. Zasoby reklamowe do wstawienia.

InsertLfpSaleRequest

Żądanie dotyczące metody InsertLfpSale.

Pola
parent

string

Wymagane. Konto dostawcy danych o asortymencie lokalnym. Format: accounts/{lfp_partner}
lfp_sale

LfpSale

Wymagane. Transakcja do wstawienia.

InsertLfpStoreRequest

Wiadomość z prośbą o wykonanie metody InsertLfpStore.

Pola
parent

string

Wymagane. Format konta dostawcy danych o asortymencie lokalnym: accounts/{account}
lfp_store

LfpStore

Wymagane. Sklep, który chcesz wstawić.

LfpInventory

Lokalny asortyment sprzedawcy.

Pola
name

string

Tylko dane wyjściowe. Identyfikator. Nazwa zasobu LfpInventory. Format: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account

int64

Wymagane. Identyfikator w Merchant Center sprzedawcy, którego dotyczy przesyłany asortyment.
store_code

string

Wymagane. Identyfikator sklepu sprzedawcy. Kod sklepu wstawiony za pomocą InsertLfpStore lub kod sklepu w profilu firmy.
offer_id

string

Wymagane. Niezmienna. Unikalny identyfikator produktu. Jeśli dla sprzedawcy przesłano zarówno arkusze z asortymentem, jak i z informacjami o sprzedaży, identyfikator powinien być taki sam w przypadku tego samego produktu.

Uwaga: jeśli sprzedawca sprzedaje używane i nowe egzemplarze tego samego produktu, powinny one mieć różne identyfikatory.
region_code

string

Wymagane. Kod regionu CLDR dla kraju, w którym sprzedawany jest produkt.
content_language

string

Wymagane. Dwuliterowy kod języka ISO 639-1 dla produktu.
price

Price

Opcjonalnie: Obecna cena produktu.
availability

string

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

Timestamp

Opcjonalnie: Czas, w którym zebrano dane o zasobach. Jeśli nie zostanie ustawiona, zostanie ustawiona na czas przesłania asortymentu.
gtin

string

Opcjonalnie: Globalny numer jednostki handlowej produktu.
quantity

int64

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

string

Opcjonalnie: Obsługiwana metoda odbioru w przypadku tej oferty. Jeśli wartość nie jest „nieobsługiwana”, to pole musi być przesłane razem z atrybutem pickupSla. Akceptowane wartości atrybutów znajdziesz w specyfikacji danych o asortymencie produktów dostępnych lokalnie.
pickup_sla

string

Opcjonalnie: Przewidywana data, kiedy zamówienie będzie gotowe do odbioru, w zależności od daty złożenia zamówienia. Musi być przesłany razem z pickupMethod. Akceptowane wartości atrybutów znajdziesz w specyfikacji danych o asortymencie produktów dostępnych lokalnie.
feed_label

string

Opcjonalnie: Etykieta pliku danych produktu. Jeśli nie podasz żadnej opcji, domyślna wartość to regionCode.

LfpSale

sprzedaż dla sprzedawcy,

Pola
name

string

Tylko dane wyjściowe. Identyfikator. Nazwa zasobu LfpSale. Format: accounts/{account}/lfpSales/{sale}
target_account

int64

Wymagane. Identyfikator w Merchant Center sprzedawcy, którego dotyczy sprzedaż.
store_code

string

Wymagane. Identyfikator sklepu sprzedawcy. storeCode wstawiony za pomocą interfejsu API lub kod sklepu w profilu firmy.
offer_id

string

Wymagane. Unikalny identyfikator produktu. Jeśli dla sprzedawcy przesłano zarówno arkusze z asortymentem, jak i sprzedaż, identyfikator powinien być taki sam w przypadku tego samego produktu.

Uwaga: jeśli sprzedawca sprzedaje używane i nowe egzemplarze tego samego produktu, powinny one mieć różne identyfikatory.
region_code

string

Wymagane. Kod regionu CLDR dla kraju, w którym sprzedawany jest produkt.
content_language

string

Wymagane. Dwuliterowy kod języka ISO 639-1 dla produktu.
gtin

string

Wymagane. Globalny numer jednostki handlowej sprzedanego produktu.
price

Price

Wymagane. Cena jednostkowa produktu.
quantity

int64

Wymagane. Zmiana względna dostępnej ilości. Wartość jest ujemna w przypadku zwróconych produktów.
sale_time

Timestamp

Wymagane. Sygnatura czasowa sprzedaży.
uid

string

Tylko dane wyjściowe. Wygenerowany przez system unikalny identyfikator globalny dla LfpSale.
feed_label

string

Opcjonalnie: Etykieta pliku danych produktu. Jeśli nie podasz żadnej opcji, domyślna wartość to regionCode.

LfpStore

Sklep sprzedawcy. Będzie on używany do dopasowywania do sklepu w profilu firmy w Google wybranego sprzedawcy. Jeśli nie uda się znaleźć pasującego sklepu, asortymenty ani sprzedaż przesłane z kodem sklepu nie zostaną wykorzystane.

Pola
name

string

Tylko dane wyjściowe. Identyfikator. Nazwa zasobu LfpStore. Format: accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account

int64

Wymagane. Identyfikator w Merchant Center sprzedawcy, którego dotyczy sklep.
store_code

string

Wymagane. Niezmienna. Identyfikator sklepu, który jest unikalny dla danego sprzedawcy docelowego.
store_address

string

Wymagane. Adres sklepu. Przykład: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA.
gcid_category[]

string

Opcjonalnie: Identyfikator kategorii w Google Moja Firma.
matching_state

StoreMatchingState

Opcjonalnie: Tylko dane wyjściowe. Stan dopasowania do profilu firmy w Google. Więcej informacji znajdziesz w artykule matchingStateHint, jeśli nie znajdziesz pasujących wyników.
store_name

string

Opcjonalnie: Nazwa sprzedawcy lub sklepu.
phone_number

string

Opcjonalnie: Numer telefonu sklepu w formacie E.164. Przykład: +15556767888
website_uri

string

Opcjonalnie: Adres URL witryny sklepu lub sprzedawcy.
place_id

string

Opcjonalnie: Identyfikator miejsca w Miejscach Google lokalizacji sklepu.
matching_state_hint

string

Opcjonalnie: Tylko dane wyjściowe. Wskazówka dotycząca przyczyny niepowodzenia dopasowania. Tę wartość ustawia się tylko wtedy, gdy matchingState=STORE_MATCHING_STATE_FAILED.

Możliwe wartości to:

  • „linked-store-not-found”: nie ma żadnych sklepów w Profilu Firmy w Google pasujących do wyszukiwania.
  • „store-match-not-found”: nie udało się dopasować podanego LfpStore do żadnego z połączonych sklepów w Profilu Firmy w Google. Konto Merchant Center jest prawidłowo połączone, sklepy są dostępne w Profilu Firmy w Google, ale adres LfpStore nie jest zgodny z adresami w Profilu Firmy w Google. Zaktualizuj adres LfpStore lub adres sklepu w Profilu Firmy w Google, aby był on zgodny.
  • „store-match-unverified”: nie udało się dopasować podanego LfpStore do żadnego z połączonych sklepów w Profilu Firmy w Google, ponieważ dopasowany sklep w Profilu Firmy w Google nie został zweryfikowany. Przejdź proces weryfikacji profilu firmy w Google, aby uzyskać zgodność.

StoreMatchingState

Stan dopasowywania LfpStore do profilu firmy w Google.

Wartości w polu enum
STORE_MATCHING_STATE_UNSPECIFIED Nieokreślony stan dopasowania sklepu.
STORE_MATCHING_STATE_MATCHED LfpStore został dopasowany do sklepu w Profilu Firmy w Google.
STORE_MATCHING_STATE_FAILED LfpStore nie został dopasowany do sklepu w Profilu Firmy w Google.

ListLfpStoresRequest

Komunikat żądania dla metody ListLfpStores.

Pola
parent

string

Wymagane. Partner w programie LFP. Format: accounts/{account}
target_account

int64

Wymagane. Identyfikator sprzedawcy w Merchant Center, którego sklepy mają być wyświetlane.
page_size

int32

Opcjonalnie: Maksymalna liczba zwracanych zasobów LfpStore dla danego konta. Jeśli liczba sklepów na danym koncie jest mniejsza niż pageSize, usługa zwraca mniejszą wartość. Wartością domyślną jest 250. Maksymalna wartość to 1000. Jeśli zostanie podana wyższa wartość, pageSize zostanie domyślnie ustawiona na maksimum.
page_token

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji ListLfpStoresRequest. Podaj token strony, aby pobrać kolejną stronę. Podczas podziału na strony wszystkie inne parametry przekazywane do funkcji ListLfpStoresRequest muszą być zgodne z wywołaniem, które dostarczyło token strony. Token zwrócony jako nextPageToken w odpowiedzi na poprzednie żądanie.

ListLfpStoresResponse

Odpowiedź na metodę ListLfpStores.

Pola
lfp_stores[]

LfpStore

sklepy określonego sprzedawcy,
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.