Package google.shopping.merchant.lfp.v1beta

Indeks

LfpInventoryService

Usługa dla partnera w ramach programu partnerskiego danych, która umożliwia przesyłanie lokalnego asortymentu produktów sprzedawcy.

InsertLfpInventory

rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory)

Wstawia zasób LfpInventory dla danego docelowego konta sprzedawcy. Jeśli zasób już istnieje, zostanie zastąpiony. Zasoby reklamowe tracą ważność automatycznie po 30 dniach.

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.

LfpSaleService

Usługa dla partnera w ramach programu partnerskiego danych, która umożliwia przesyłanie danych o sprzedaży dotyczących 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 omówieniu protokołu OAuth 2.0.

LfpStoreService

Usługa dla partnera w ramach programu partnerskiego danych, która umożliwia przesyłanie lokalnych sklepów w imieniu 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 omówieniu protokołu OAuth 2.0.
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 omówieniu protokołu OAuth 2.0.
InsertLfpStore

rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore)

Wstawia sklep docelowego sprzedawcy. Jeśli sklep z tym kodem już istnieje, zostanie zastąpiony.

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.
ListLfpStores

rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse)

Zawiera listę sklepów docelowego sprzedawcy określonych za pomocą filtra w: ListLfpStoresRequest.

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.

DeleteLfpStoreRequest

Komunikat żądania dotyczący metody DeleteLfpStore.

Pola
name

string

Wymagane. Nazwa sklepu, który ma zostać usunięty z docelowego konta sprzedawcy. Format: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

Prośba o wiadomość dla metody GetLfpStore.

Pola
name

string

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

InsertLfpInventoryRequest

Prośba o wiadomość dla metody InsertLfpInventory.

Pola
parent

string

Wymagane. Konto dostawcy LFP. Format: accounts/{account}
lfp_inventory

LfpInventory

Wymagane. Zasoby reklamowe do wstawienia.

InsertLfpSaleRequest

Komunikat żądania dotyczący metody InsertLfpSale.

Pola
parent

string

Wymagane. Konto dostawcy LFP. Format: accounts/{lfp_partner}
lfp_sale

LfpSale

Wymagane. Sprzedaż do wstawienia.

InsertLfpStoreRequest

Komunikat żądania dla metody InsertLfpStore.

Pola
parent

string

Wymagane. Format konta dostawcy LFP: accounts/{account}
lfp_store

LfpStore

Wymagane. Sklep do wstawienia.

LfpInventory

Lokalny asortyment dla 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 sprzedawcy w Merchant Center, dla którego chcesz przesłać asortyment.
store_code

string

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

string

Wymagane. Stałe. Unikalny identyfikator produktu. Jeśli przesyłasz zarówno asortyment, jak i dane o sprzedaży w przypadku sprzedawcy, ten identyfikator powinien być taki sam dla tego samego produktu.

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

string

Wymagane. Kod regionu CLDR odpowiadający krajowi, w którym produkt jest sprzedawany.
content_language

string

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

Price

Opcjonalnie. Aktualna cena produktu.
availability

string

Wymagane. Dostępność produktu w tym sklepie. Akceptowane wartości atrybutów znajdziesz w specyfikacji danych lokalnego asortymentu produktów.
collection_time

Timestamp

Opcjonalnie. Godzina zbierania zasobów reklamowych. Jeśli zasada nie jest skonfigurowana, ustawiany będzie na moment przesłania zasobów reklamowych.
gtin

string

Opcjonalnie. Globalny numer jednostki handlowej produktu.
quantity

int64

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

string

Opcjonalnie. Obsługiwana metoda odbioru w przypadku tej oferty. Jeśli wartość nie jest obsługiwana, pole należy przesłać razem z polem pickupSla. Akceptowane wartości atrybutów znajdziesz w specyfikacji danych lokalnego asortymentu produktów.
pickup_sla

string

Opcjonalnie. Oczekiwana data, kiedy zamówienie będzie gotowe do odbioru, w zależności od daty zamówienia. Należy je przesłać razem z atrybutem pickupMethod. Akceptowane wartości atrybutów znajdziesz w specyfikacji danych lokalnego asortymentu produktów.
feed_label

string

Opcjonalnie. Etykieta pliku danych produktu. Jeśli zasada nie jest skonfigurowana, domyślnie używany jest regionCode.

LfpSale

Promocja dla sprzedawcy.

Pola
name

string

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

int64

Wymagane. Identyfikator sprzedawcy w Merchant Center, w przypadku którego chcesz przesłać informacje o sprzedaży.
store_code

string

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

string

Wymagane. Unikalny identyfikator produktu. Jeśli przesyłasz zarówno asortyment, jak i dane o sprzedaży w przypadku sprzedawcy, ten identyfikator powinien być taki sam dla tego samego produktu.

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

string

Wymagane. Kod regionu CLDR odpowiadający krajowi, w którym produkt jest sprzedawany.
content_language

string

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

string

Wymagane. Globalny numer jednostki handlowej sprzedawanego produktu.
price

Price

Wymagane. Cena jednostkowa produktu.
quantity

int64

Wymagane. Względna zmiana dostępnej ilości. Wartość ujemna dla zwróconych produktów.
sale_time

Timestamp

Wymagane. Sygnatura czasowa sprzedaży.
uid

string

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

string

Opcjonalnie. Etykieta pliku danych produktu. Jeśli zasada nie jest skonfigurowana, domyślnie używany jest regionCode.

LfpStore

Sklep dla sprzedawcy. Użyjemy ich do dopasowania do sklepu w Profilu Firmy w Google docelowego sprzedawcy. Jeśli nie uda się znaleźć pasującego sklepu, asortyment lub sprzedaż przesłane za pomocą kodu sklepu nie będą używane.

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 sklep chcesz przesłać.
store_code

string

Wymagane. Stałe. Unikalny identyfikator sklepu 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. Jeśli nie zostaną znalezione żadne pasujące wyniki, wejdź na matchingStateHint, aby dowiedzieć się więcej.
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 Miejsc Google lokalizacji sklepu.
matching_state_hint

string

Opcjonalnie. Tylko dane wyjściowe. Wskazówka dotycząca przyczyny niepowodzenia dopasowania. Tę wartość można ustawić 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 adresu 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 lokalizacji LfpStore nie pasuje do adresów w Profilu Firmy w Google. Zaktualizuj adres firmy w: LfpStore lub adres sklepu w Profilu Firmy w Google, aby był zgodny.
  • „store-match-unverified”: nie udało się dopasować podanego numeru LfpStore do żadnego z połączonych sklepów w Profilu Firmy w Google, ponieważ pasujący sklep w Profilu Firmy w Google nie został zweryfikowany. Aby potwierdzić prawidłową zgodność, przejdź proces weryfikacji Profilu Firmy w Google.

StoreMatchingState

Stan dopasowania firmy LfpStore do profilu firmy w Google.

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

ListLfpStoresRequest

Komunikat żądania dla metody ListLfpStores.

Pola
parent

string

Wymagane. z partnerem LFP, Format: accounts/{account}
target_account

int64

Wymagane. Identyfikator w Merchant Center sprzedawcy, dla którego chcesz wyświetlić listę sklepów.
page_size

int32

Opcjonalnie. Maksymalna liczba zasobów LfpStore, które można zwrócić przez dane konto. Usługa zwraca mniej od tej wartości, jeśli liczba sklepów na danym koncie jest mniejsza niż pageSize. Wartością domyślną jest 250. Maksymalna wartość to 1000. Jeśli zostanie określona wartość większa niż maksymalna, pageSize domyślnie ustawi wartość maksymalną.
page_token

string

Opcjonalnie. Token strony odebrany z poprzedniego wywołania ListLfpStoresRequest. Podaj token strony, aby pobrać kolejną stronę. W przypadku podziału na strony wszystkie pozostałe parametry podane w interfejsie ListLfpStoresRequest muszą odpowiadać wywołaniu, które podało token strony. Token zwrócony jako nextPageToken w odpowiedzi na poprzednie żądanie.

ListLfpStoresResponse

Komunikat z odpowiedzią dla metody ListLfpStores.

Pola
lfp_stores[]

LfpStore

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