Package google.shopping.css.v1

Indeks

AccountLabelsService

Zarządza etykietami kont Merchant Center i usług porównywania cen.

CreateAccountLabel

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

Tworzy nową etykietę, która nie jest przypisana do żadnego konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
DeleteAccountLabel

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

Usuwa etykietę i usuwanie jej ze wszystkich kont, do których została przypisana.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
ListAccountLabels

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

Wyświetla etykiety należące do konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
UpdateAccountLabel

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

Aktualizuje etykietę.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

AccountsService

Usługa do zarządzania informacjami o koncie usługi porównywania cen/multikonta klientów.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Pobiera pojedyncze konto usługi porównywania cen/multikonta klientów według identyfikatora.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
ListChildAccounts

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

Wyświetla wszystkie konta pod podanym identyfikatorem konta usługi porównywania cen. Opcjonalnie filtruje według identyfikatora etykiety i nazwy konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
UpdateLabels

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

Aktualizuje etykiety przypisane do kont usługi porównywania cen/multikonta klientów według domeny usługi porównywania cen.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

CssProductInputsService

Usługa korzystająca z zasobu CssProductInput. Ta usługa pomaga w wstawianiu, aktualizowaniu i usuwaniu produktów w usłudze porównywania cen.

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

Usuwa dane produktu usługi porównywania cen z konta CSS Center.

Po usunięciu może minąć kilka minut, zanim dane wejściowe staną się niedostępne.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
InsertCssProductInput

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

Przesyłanie pliku CssProductInput na konto CSS Center. Jeśli dane o tych samych wartościach w kolumnach contentLanguage, identity, feedLabel i feedId już istnieją, ta metoda zastąpi te dane.

Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu w usłudze porównywania cen może minąć kilka minut, zanim przetworzony produkt w usłudze porównywania cen będzie można pobrać.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
UpdateCssProductInput

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

Zaktualizuje istniejące dane produktu w usłudze porównywania cen na koncie CSS Center.

Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu w usłudze porównywania cen może minąć kilka minut, zanim przetworzony produkt w usłudze porównywania cen będzie można pobrać.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

CssProductsService

Usługa do pobierania i wyświetlania produktów w usłudze porównywania cen(wewnętrznie nazywanych ofertą zbiorczą).

GetCssProduct

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

Pobiera przetworzony produkt w usłudze porównywania cen z Twojego konta CSS Center. Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu może minąć kilka minut, zanim zaktualizowany produkt końcowy będzie można pobrać.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
ListCssProducts

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

Wyświetla przetworzone produkty w usłudze porównywania cen na Twoim koncie CSS Center. Odpowiedź może zawierać mniej elementów niż określono w parametrze pageSize. Użyj parametru pageToken, aby określić, czy są jeszcze inne elementy, których możesz zażądać.

Po wstawieniu, zaktualizowaniu lub usunięciu danych produktu w usłudze porównywania cen może minąć kilka minut, zanim zaktualizowany przetworzony produkt w usłudze porównywania cen będzie można pobrać.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

QuotaService

Usługa umożliwiająca uzyskanie informacji o limitach wywołań metody w ramach interfejsu CSS API.

ListQuotaGroups

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

Wyświetla dzienny limit połączeń i wykorzystanie na grupę na koncie CSS Center.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

Konto

Informacje o koncie usługi porównywania cen/multikoncie klientów

Pola
name

string

Nazwa zasobu etykiety. Format: accounts/{account}
full_name

string

Tylko dane wyjściowe. Niezmienna. Imię i nazwisko właściciela konta Merchant Center lub Merchant Center for Sellers.
label_ids[]

int64

ręcznie utworzone identyfikatory etykiety przypisane do konta usługi porównywania cen/MC przez konto nadrzędne usługi porównywania cen.
automatic_label_ids[]

int64

Automatycznie utworzone identyfikatory etykiety przypisane do konta MC przez CSS Center.
account_type

AccountType

Tylko dane wyjściowe. Typ tego konta.
display_name

string

Krótka wyświetlana nazwa konta usługi porównywania cen.
homepage_uri

string

Tylko dane wyjściowe. Niezmienna. Strona główna konta usługi porównywania cen/multikonta klientów.
parent

string

Zasób nadrzędny konta usługi porównywania cen/MC. Grupa usług porównywania cen dla domen usług porównywania cen; domena usługi porównywania cen dla kont MC. Zwracany tylko wtedy, gdy użytkownik ma dostęp do konta nadrzędnego. Uwaga: w przypadku subkont MC jest to też domena usługi porównywania cen, która jest zasobem nadrzędnym konta MCA, ponieważ w efekcie spłaszczamy hierarchię.

AccountType

Typ konta.

Wartości w polu enum
ACCOUNT_TYPE_UNSPECIFIED Nieznany typ konta.
CSS_GROUP Konto grupy usług porównywania cen.
CSS_DOMAIN Konto domeny usługi porównywania cen.
MC_PRIMARY_CSS_MCA MC Podstawowe MCA usługi porównywania cen.
MC_CSS_MCA MC CSS MCA account.
MC_MARKETPLACE_MCA MCA na platformie handlowej MC.
MC_OTHER_MCA MC Inne konto MCA.
MC_STANDALONE Samodzielne konto MC.
MC_MCA_SUBACCOUNT Subkonto MCA w MC.

AccountLabel

Etykieta przypisana przez domenę usługi porównywania cen lub grupę usług porównywania cen do jednego z jej subkont.

Pola
name

string

Identyfikator. Nazwa zasobu etykiety. Format: konta/{konto}/etykiety/{etykieta}
label_id

int64

Tylko dane wyjściowe. Identyfikator etykiety.
account_id

int64

Tylko dane wyjściowe. Identyfikator konta, do którego należy ta etykieta.
label_type

LabelType

Tylko dane wyjściowe. Typ tej etykiety.
display_name

string

Wyświetlana nazwa tej etykiety.
description

string

Opis tej etykiety.

LabelType

Typ etykiety.

Wartości w polu enum
LABEL_TYPE_UNSPECIFIED Nieznany typ etykiety.
MANUAL Wskazuje, że etykieta została utworzona ręcznie.
AUTOMATIC Oznacza, że etykieta została utworzona automatycznie przez CSS Center.

Atrybuty

Atrybuty produktu w usłudze porównywania cen.

Pola
low_price

Price

Niska cena produktu w usłudze porównywania cen.
high_price

Price

Wysoka cena produktu w usłudze porównywania cen.
headline_offer_price

Price

Cena produktu w usłudze porównywania cen w nagłówku.
headline_offer_shipping_price

Price

Cena produktu w usłudze porównywania cen w nagłówku.
product_types[]

string

Kategorie produktu (sformatowane zgodnie ze specyfikacją danych produktów).
size_types[]

string

Krój produktu. Można go używać do reprezentowania połączonych typów rozmiarów produktów odzieżowych. Możesz podać maksymalnie 2 typy rozmiarów (patrz [https://support.google.com/merchants/answer/6324497](typ rozmiaru)).
product_details[]

ProductDetail

Dane techniczne lub dodatkowe informacje o produkcie.
product_weight

ProductWeight

Waga produktu w podanych jednostkach. Wartość musi zawierać się w zakresie od 0 (wykluczając tę wartość) do 2000 (włącznie).
product_length

ProductDimension

Długość produktu w podanych jednostkach. Wartość musi mieścić się w zakresie od 0 (wykluczając tę wartość) do 3000 (włącznie).
product_width

ProductDimension

Szerokość produktu w podanych jednostkach. Wartość musi mieścić się w zakresie od 0 (wykluczając tę wartość) do 3000 (włącznie).
product_height

ProductDimension

Wysokość produktu w podanych jednostkach. Wartość musi mieścić się w zakresie od 0 (wykluczając tę wartość) do 3000 (włącznie).
product_highlights[]

string

Punkty opisujące najważniejsze informacje o produkcie.
certifications[]

Certification

Lista certyfikatów zgłoszonych przez usługę porównywania cen dla danego produktu.
expiration_date

Timestamp

Data, w której element ma wygasnąć, określona podczas jego dodania w formacie ISO 8601. Rzeczywista data wygaśnięcia jest widoczna w productstatuses jako googleExpirationDate i może być wcześniejsza, jeśli expirationDate przypada w zbyt odległej przyszłości. Uwaga: usunięcie produktu może potrwać ponad 2 dni od daty wygaśnięcia.
included_destinations[]

string

Lista miejsc docelowych do uwzględnienia w przypadku tej wartości docelowej (odpowiada zaznaczonym polom wyboru w Merchant Center). Domyślne miejsca docelowe są zawsze uwzględniane, chyba że podano je w polu excludedDestinations.
excluded_destinations[]

string

Lista miejsc docelowych do wykluczenia w przypadku tej wartości docelowej (odpowiada odznaczonym polom wyboru w Merchant Center).
headline_offer_installment

HeadlineOfferInstallment

Liczba i wysokość rat do zapłaty za produkt.
headline_offer_subscription_cost

HeadlineOfferSubscriptionCost

Liczba okresów (miesięcy lub lat) i kwota płatności za okres abonamentu.
cpp_ads_redirect

string

Umożliwia reklamodawcom zastąpienie adresu URL produktu, gdy produkt jest wyświetlany w kontekście reklamy produktowej.
number_of_offers

int64

Liczba produktów w usłudze porównywania cen.
headline_offer_condition

string

Stan produktu objętego ofertą w nagłówku.
title

string

Tytuł produktu.
description

string

Opis produktu.
brand

string

Atrybuty związane z produktem.[14-36] Marka produktu.
mpn

string

Numer katalogowy (MPN) produktu.
gtin

string

Globalny Numer Jednostki Handlowej (GTIN) produktu.
google_product_category

string

kategoria produktu według Google (patrz mapa kategorii produktów Google). Gdy zapytasz o produkty, to pole będzie zawierać wartość podana przez użytkownika. Obecnie nie ma możliwości przywrócenia automatycznie przypisanych kategorii produktów Google za pomocą interfejsu API.
adult

bool

Ustaw jako prawda, jeśli produkt jest kierowany do dorosłych.
multipack

int64

Liczba identycznych produktów w opakowaniu zbiorczym przygotowanym przez sprzedawcę.
is_bundle

bool

Określa, czy produkt jest pakietem utworzonym przez sprzedawcę. Pakiet to niestandardowa grupa różnych produktów sprzedawanych przez sprzedawcę za jedną cenę.
age_group

string

Docelowa grupa wiekowa, dla której jest przeznaczony produkt.
color

string

Kolor produktu.
gender

string

Docelowa płeć klientów, dla których jest przeznaczony produkt.
material

string

Materiał, z którego wykonano produkt.
pattern

string

Wzór produktu (np. kropki).
size

string

Rozmiar produktu. Dozwolona jest tylko 1 wartość. W przypadku wersji w różnych rozmiarach wstaw osobny produkt dla każdego rozmiaru z tą samą wartością itemGroupId (patrz [https://support.google.com/merchants/answer/6324492](definicja rozmiaru)).
size_system

string

System, w którym podano rozmiar. Zalecany w przypadku produktów odzieżowych.
item_group_id

string

Wspólny identyfikator wszystkich wersji tego samego produktu.
pause

string

Publikacja tego elementu zostanie tymczasowo wstrzymana.
custom_label_0

string

Etykieta własna 0 służąca do niestandardowego grupowania produktów w kampanii produktowej.
custom_label_1

string

Etykieta własna 1 służąca do niestandardowego grupowania produktów w kampanii produktowej.
custom_label_2

string

Etykieta własna 2 służąca do niestandardowego grupowania produktów w kampanii produktowej.
custom_label_3

string

Etykieta własna 3 służąca do niestandardowego grupowania produktów w kampanii produktowej.
custom_label_4

string

Etykieta własna 4 służąca do niestandardowego grupowania produktów w kampanii produktowej.

Certyfikat

Certyfikat produktu. Użyj tego atrybutu, aby dodać informacje o certyfikatach, np. certyfikacie efektywności energetycznej, powiązanych z produktem.

Pola
name

string

Nazwa certyfikatu. Obecnie najczęstszą wartością jest „EPREL”, która reprezentuje certyfikaty efektywności energetycznej w bazie danych europejskiego rejestru produktów do celów etykietowania energetycznego (EPREL).
authority

string

Organ lub podmiot wydający certyfikat. Obecnie najczęstszą wartością dla etykiet energetycznych w UE jest „EC” lub „European_Commission”.
code

string

Kod certyfikatu. Na przykład w przypadku certyfikatu EPREL z linkiem https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 kod to 123456. Kod jest wymagany dla europejskich etykiet energetycznych.

CreateAccountLabelRequest

Wiadomość z prośbą o wykonanie metody „CreateAccountLanel”.

Pola
parent

string

Wymagane. Konto nadrzędne. Format: accounts/{account}
account_label

AccountLabel

Wymagane. Etykieta do utworzenia.

CssProduct

Przetworzony produkt w usłudze porównywania cen.

Pola
name

string

Nazwa usługi porównywania cen. Format: "accounts/{account}/cssProducts/{css_product}"
raw_provided_id

string

Tylko dane wyjściowe. Unikalny identyfikator produktu.
content_language

string

Tylko dane wyjściowe. Dwuliterowy kod języka ISO 639-1 produktu.
feed_label

string

Tylko dane wyjściowe. Etykieta pliku danych produktu.
attributes

Attributes

Tylko dane wyjściowe. Lista atrybutów produktu.
custom_attributes[]

CustomAttribute

Tylko dane wyjściowe. Lista atrybutów niestandardowych (dostarczanych przez CSS). Można go też użyć do przesyłania dowolnego atrybutu specyfikacji pliku danych w formie ogólnej (np. { "name": "size type", "value": "regular" }). Jest to przydatne w przypadku przesyłania atrybutów, których interfejs API nie udostępnia wprost, np. dodatkowych atrybutów używanych w usłudze Kup przez Google.
css_product_status

CssProductStatus

Tylko dane wyjściowe. stan produktu, problemy z weryfikacją danych, czyli informacje o produkcie obliczone asynchronicznie.

CssProductInput

Ten zasób reprezentuje dane wejściowe przesłane przez Ciebie w przypadku produktu w usłudze porównywania cen, a nie przetworzonego produktu w usłudze porównywania cen, który widzisz w CSS Center, w reklamach produktowych lub w innych miejscach w Google.

Pola
name

string

Identyfikator. Nazwa wejścia „Produkt w usłudze porównywania cen”. Format: accounts/{account}/cssProductInputs/{css_product_input}, gdzie ostatnia sekcja css_product_input składa się z 3 części: contentLanguage~feedLabel~offerId. Przykład: accounts/123/cssProductInputs/de~DE~rawProvidedId123
final_name

string

Tylko dane wyjściowe. Nazwa przetworzonego produktu w usłudze porównywania cen. Format: accounts/{account}/cssProducts/{css_product} "
raw_provided_id

string

Wymagane. Unikalny identyfikator usługi w usłudze porównywania cen. To samo dotyczy danych produktu w usłudze porównywania cen i przetworzonego produktu w usłudze porównywania cen. Dozwolone są tylko identyfikatory zawierające znaki alfanumeryczne, podkreślenia i łączniki. Szczegółowe informacje znajdziesz w specyfikacji pliku danych o produktach.
content_language

string

Wymagane. Dwuliterowy kod języka ISO 639-1 produktu w usłudze porównywania cen.
feed_label

string

Wymagane. Etykieta pliku danych produktu w usłudze porównywania cen. Etykieta pliku danych jest synonimem „kraj docelowy” i z tego powodu powinna zawsze zawierać prawidłowy kod regionu. Przykład: „DE” w przypadku Niemiec, „FR” w przypadku Francji.
freshness_time
(deprecated)

Timestamp

WYCOFANY. Zamiast tego użyj atrybutu expiration_date. Reprezentuje bieżącą wersję (aktualność) usługi w usłudze porównywania cen, która może być używana do zachowania prawidłowej kolejności, gdy wiele aktualizacji jest wykonywanych jednocześnie.

To pole nie może mieć ustawionego czasu przyszłego.

Jeśli jest ustawiona, zapobiega ona aktualizacji, jeśli nowsza wersja produktu jest już dostępna w naszym systemie (czyli czas ostatniej aktualizacji istniejących produktów w usłudze porównywania cen jest późniejszy niż czas świeżości ustawiony w aktualizacji). Jeśli nastąpiła aktualizacja, czas ostatniej aktualizacji zostanie ustawiony na ten czas świeżości.

Jeśli nie zostanie ustawiony, aktualizacja nie zostanie zablokowana, a czas ostatniej aktualizacji zostanie domyślnie ustawiony na moment otrzymania tej prośby przez interfejs CSS API.

Jeśli operacja zostanie zablokowana, zostanie wywołany wyjątek przerwania.
attributes

Attributes

Lista atrybutów produktów w usłudze porównywania cen.
custom_attributes[]

CustomAttribute

Lista atrybutów niestandardowych (dostarczanych przez CSS). Można go też używać do przesyłania dowolnego atrybutu specyfikacji pliku danych w jego ogólnej formie (np. { "name": "size type", "value": "regular" }). Jest to przydatne w przypadku przesyłania atrybutów, które nie są jawnie udostępniane przez interfejs API, takich jak dodatkowe atrybuty używane w usłudze Kup przez Google.

CssProductStatus

Stan usługi porównywania cen, problemy z weryfikacją danych, czyli informacje o usłudze porównywania cen obliczone asynchronicznie.

Pola
destination_statuses[]

DestinationStatus

Przeznaczenie produktu.
item_level_issues[]

ItemLevelIssue

Lista wszystkich problemów związanych z produktem.
creation_date

Timestamp

Data utworzenia elementu w formacie ISO 8601.
last_update_date

Timestamp

Data ostatniej aktualizacji elementu w formacie ISO 8601.
google_expiration_date

Timestamp

Data wygaśnięcia produktu w formacie ISO 8601.

DestinationStatus

Stan docelowy produktu.

Pola
destination

string

Nazwa miejsca docelowego
approved_countries[]

string

Lista kodów krajów (ISO 3166-1 alpha-2), w których produkt jest zatwierdzony.
pending_countries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których usługa w ramach programu CSS oczekuje na zatwierdzenie.
disapproved_countries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których usługa w ramach programu CSS została odrzucona.

ItemLevelIssue

Stan produktu na poziomie produktu.

Pola
code

string

Kod błędu.
servability

string

Jak ten problem wpływa na wyświetlanie produktu w usłudze porównywania cen.
resolution

string

Czy problem może zostać rozwiązany przez sprzedawcę.
attribute

string

nazwę atrybutu, jeśli problem jest spowodowany przez pojedynczy atrybut.
destination

string

Miejsce docelowe, którego dotyczy problem.
description

string

Krótki opis problemu w języku angielskim.
detail

string

szczegółowy opis problemu w języku angielskim.
documentation

string

adres URL strony internetowej, która pomoże nam rozwiązać ten problem.
applicable_countries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w przypadku których problem dotyczy usługi w ramach usługi porównywania cen.

DeleteAccountLabelRequest

wiadomość z prośbą o usunięcie etykiety konta (metoda „DeleteAccountLabel”);

Pola
name

string

Wymagane. Nazwa etykiety do usunięcia. Format: konta/{konto}/etykiety/{etykieta}

DeleteCssProductInputRequest

Komunikat z prośbą o wykonanie metody DeleteCssProductInput.

Pola
name

string

Wymagane. Nazwa zasobu wejściowego produktu w usłudze porównywania cen, który chcesz usunąć. Format: accounts/{account}/cssProductInputs/{css_product_input}, gdzie ostatnia sekcja css_product_input składa się z 3 części: contentLanguage~feedLabel~offerId. Przykład: accounts/123/cssProductInputs/de~DE~rawProvidedId123
supplemental_feed_id

int64

Identyfikator dodatkowego pliku danych Content API. Jeśli działanie dotyczy podstawowego pliku danych, nie musisz ustawiać tego pola. Jeśli to pole jest ustawione, działanie dotyczące produktu będzie stosowane do dodatkowego pliku danych zamiast do podstawowego pliku danych Content API.

GetAccountRequest

Komunikat żądania dla metody GetAccount.

Pola
name

string

Wymagane. Nazwa zarządzanego konta usługi porównywania cen lub usługi porównywania cen i rezerwacji. Format: accounts/{account}
parent

string

Opcjonalnie. Wymagany tylko podczas pobierania informacji o koncie MC. Domena usługi porównywania cen, która jest zasobem nadrzędnym konta MC. Format: accounts/{account}

GetCssProductRequest

wiadomość z prośbą o wykonanie metody GetCssProduct,

Pola
name

string

Wymagane. Nazwa usługi porównywania cen do pobrania.

HeadlineOfferInstallment

Wiadomość reprezentująca ratę.

Pola
months

int64

Liczba rat, które kupujący musi zapłacić.
amount

Price

Miesięczna kwota do zapłacenia przez kupującego.
downpayment

Price

Kwota wpłaty wstępnej, którą kupujący musi zapłacić z góry.

HeadlineOfferSubscriptionCost

Koszt subskrypcji produktu.

Pola
period

SubscriptionPeriod

Typ okresu subskrypcji. Obsługiwane wartości: * month * year
period_length

int64

Liczba okresów abonamentowych, które kupujący jest zobowiązany opłacić.
amount

Price

Kwota, którą kupujący jest zobowiązany opłacić za okres abonamentu.

InsertCssProductInputRequest

wiadomość z prośbą o wykonanie metody InsertCssProductInput,

Pola
parent

string

Wymagane. Konto, na którym zostanie wstawiony ten produkt w usłudze porównywania cen. Format: accounts/{account}
css_product_input

CssProductInput

Wymagane. Dane wejściowe produktu w usłudze porównywania cen, które chcesz wstawić.
feed_id
(deprecated)

int64

Opcjonalnie. WYCOFANY. Identyfikator pliku danych nie jest wymagany w przypadku produktów w usłudze porównywania cen. Identyfikator podstawowego lub dodatkowego pliku danych. Jeśli produkt w usłudze porównywania cen już istnieje, a podany identyfikator pliku danych jest inny, produkt zostanie przeniesiony do nowego pliku danych. Uwaga: obecnie usługi porównywania cen nie muszą podawać identyfikatorów plików danych, ponieważ tworzymy je na bieżąco. Nie obsługujemy jeszcze dodatkowych plików danych w przypadku produktów w usłudze porównywania cen.

ListAccountLabelsRequest

Żądanie wiadomości dla metody ListAccountLabels.

Pola
parent

string

Wymagane. Konto nadrzędne. Format: accounts/{account}
page_size

int32

Maksymalna liczba etykiet do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwróci się maksymalnie 50 etykiet. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną skonwertowane na 1000.
page_token

string

Token strony otrzymany z poprzedniego wywołania funkcji ListAccountLabels. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListAccountLabels muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListAccountLabelsResponse

wiadomość z odpowiedzią dla metody ListAccountLabels,

Pola
account_labels[]

AccountLabel

Etykiety z wybranego konta.
next_page_token

string

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

ListChildAccountsRequest

wiadomość z prośbą o wykonanie metody ListChildAccounts,

Pola
parent

string

Wymagane. Konto nadrzędne. Musi to być grupa usług porównywania cen lub domena. Format: accounts/{account}
page_size

int32

Opcjonalnie. Maksymalna liczba kont do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwróci się maksymalnie 50 kont. Maksymalna wartość to 100. Wartości powyżej 100 zostaną przymusowo ustawione na 100.
page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListChildAccounts. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListChildAccounts muszą być zgodne z wywołaniem, które dostarczyło token strony.
label_id

int64

Jeśli jest ustawiona, zwrócone zostaną tylko konta MC z podanym identyfikatorem etykiety.
full_name

string

Jeśli jest ustawiona, zwrócone zostaną tylko konta MC o podanej nazwie (wielkość liter ma znaczenie).

ListChildAccountsResponse

wiadomość z odpowiedzią dla metody ListChildAccounts,

Pola
accounts[]

Account

Konta usługi porównywania cen/Merchant Center zwracane dla określonego konta nadrzędnego usługi porównywania cen.
next_page_token

string

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

ListCssProductsRequest

wiadomość z prośbą o wykonanie metody ListCssProducts;

Pola
parent

string

Wymagane. Konto lub domenę, dla których mają być wyświetlane przetworzone usługi porównywania cen. Format: accounts/{account}
page_size

int32

Maksymalna liczba produktów w usłudze porównywania cen, które mają zostać zwrócone. Usługa może zwrócić mniej niż ta wartość. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną skonwertowane na 1000. Jeśli nie określisz tej wartości, zwrócona zostanie maksymalna liczba produktów w usłudze porównywania cen.
page_token

string

Token strony otrzymany z poprzedniego wywołania funkcji ListCssProducts. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListCssProducts muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListCssProductsResponse

Odpowiedź na metodę ListCssProducts.

Pola
css_products[]

CssProduct

Przetworzone produkty usługi porównywania cen z wybranego konta. Są to przetworzone produkty w usłudze porównywania cen po zastosowaniu reguł i dodatkowych plików danych.
next_page_token

string

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

ListQuotaGroupsRequest

Żądanie wiadomości dla metody ListQuotaGroups.

Pola
parent

string

Wymagane. Konto usługi porównywania cen, które jest właścicielem zbioru limitów metod i zasobów. W większości przypadków jest to domena usługi porównywania cen. Format: accounts/{account}
page_size

int32

Opcjonalnie. Maksymalna liczba limitów do zwrócenia w odpowiedzi, używana do pobierania stron. Wartość domyślna to 500; wartości powyżej 1000 zostaną sformatowane na 1000.
page_token

string

Opcjonalnie. token (jeśli został podany) do pobrania kolejnej strony. Wszystkie pozostałe parametry muszą być zgodne z pierwotnym wywołaniem, które dostarczyło token strony.

ListQuotaGroupsResponse

Odpowiedź dla metody ListMethodGroups.

Pola
quota_groups[]

QuotaGroup

metody, bieżące wykorzystanie limitów i limity dla każdej grupy; Limit jest wspólny dla wszystkich metod w grupie. Grupy są posortowane malejąco według kolumny quota_usage.
next_page_token

string

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

MethodDetails

Szczegółowe informacje o poszczególnych metodach w interfejsie CSS API.

Pola
method

string

Tylko dane wyjściowe. Nazwa metody, np. cssproductsservice.listcssproducts.
version

string

Tylko dane wyjściowe. Wersja interfejsu API, do której należy metoda.
subapi

string

Tylko dane wyjściowe. Interfejs podrzędny, do którego należy metoda. W interfejsie CSS API jest to zawsze css.
path

string

Tylko dane wyjściowe. Ścieżka do metody, np. v1/cssproductsservice.listcssproducts.

ProductDetail

Szczegóły produktu.

Pola
section_name

string

Nagłówek sekcji służący do grupowania zestawu informacji o produkcie.
attribute_name

string

Nazwa szczegółów produktu.
attribute_value

string

Wartość szczegółów produktu.

ProductDimension

Wymiar produktu.

Pola
value

double

Wymagane. Wartość wymiaru w postaci liczby. Wartość może mieć maksymalnie 4 miejsca po przecinku.
unit

string

Wymagane. Jednostki wymiarów. Akceptowane wartości to: * „in” * „cm”

ProductWeight

Waga produktu.

Pola
value

double

Wymagane. Waga podana jako liczba. Waga może mieć maksymalnie 4 miejsca po przecinku.
unit

string

Wymagane. Jednostka wagi. Akceptowane wartości: * „g” * „kg” * „oz” * „lb”

QuotaGroup

Informacje o grupie metod w interfejsie CSS API. Limit jest wspólny dla wszystkich metod w grupie. Nawet jeśli żadna z metod w grupie nie ma informacji o użytkowaniu, zwracane są informacje o grupie.

Pola
name

string

Identyfikator. Nazwa zasobu grupy limitu. Format: accounts/{account}/quotas/{group} Przykład: accounts/12345678/quotas/css-products-insert Uwaga: część {group} nie musi być zgodna z określonym wzorcem.
quota_usage

int64

Tylko dane wyjściowe. Obecny limit wykorzystania, czyli liczba połączeń już wykonanych w danym dniu za pomocą metod w grupie. Dzienne limity są resetowane o 12:00 w południe czasu UTC.
quota_limit

int64

Tylko dane wyjściowe. Maksymalna liczba połączeń dozwolonych dziennie dla grupy.
quota_minute_limit

int64

Tylko dane wyjściowe. Maksymalna dozwolona liczba połączeń na minutę w grupie.
method_details[]

MethodDetails

Tylko dane wyjściowe. Lista wszystkich metod, do których ma zastosowanie limit grupy metod.

SubscriptionPeriod

Okres subskrypcji produktu.

Wartości w polu enum
SUBSCRIPTION_PERIOD_UNSPECIFIED Wskazuje, że okres subskrypcji jest nieokreślony.
MONTH Wskazuje, że okres subskrypcji to miesiąc.
YEAR Wskazuje, że okres subskrypcji to rok.

UpdateAccountLabelRequest

Żądanie wiadomości dla metody UpdateAccountLabel.

Pola
account_label

AccountLabel

Wymagane. Zaktualizowana etykieta. Należy wypełnić wszystkie pola.

UpdateAccountLabelsRequest

wiadomość z prośbą o wykonanie metody UpdateLabels,

Pola
name

string

Wymagane. Nazwa zasobu etykiety. Format: accounts/{account}
label_ids[]

int64

Lista identyfikatorów etykiet, które mają zastąpić dotychczasowe identyfikatory etykiet na koncie. Jeśli lista jest pusta, wszystkie obecnie przypisane identyfikatory etykiet zostaną usunięte.
parent

string

Opcjonalnie. Wymagane tylko podczas aktualizowania etykiet kont MC. Domena usługi porównywania cen, która jest zasobem nadrzędnym konta MC. Format: accounts/{account}

UpdateCssProductInputRequest

Komunikat żądania dla metody UpdateCssProductInput.

Pola
css_product_input

CssProductInput

Wymagane. Zasób danych produktu w usłudze porównywania cen, który chcesz zaktualizować. Przesłane informacje zostaną zastosowane również do przetworzonego produktu w usłudze porównywania cen.
update_mask

FieldMask

Lista atrybutów produktów w usłudze porównywania cen, które mają zostać zaktualizowane.

Jeśli maska aktualizacji zostanie pominięta, zostanie potraktowana jako domyślna maska pól, która jest równoważna wszystkim wypełnionym (mającym niepustą wartość) polu.

Atrybuty określone w masce aktualizacji bez wartości określonej w treści zostaną usunięte z produktu w usłudze porównywania cen.

Maskę aktualizacji można określić tylko w przypadku pól najwyższego poziomu w atrybutach i atrybutach niestandardowych.

Aby określić maskę aktualizacji dla atrybutów niestandardowych, musisz dodać prefiks custom_attribute..

Podanie specjalnej wartości „*” w przypadku pełnego zastąpienia produktu w usłudze porównywania cen nie jest obsługiwane.