Package google.shopping.css.v1

Indeks

AccountLabelsService

Zarządza etykietami kont Merchant Center i CSS.

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 sekcji OAuth 2.0 Overview.
DeleteAccountLabel

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

Usuwa etykietę i usuwa ją 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 sekcji OAuth 2.0 Overview.
ListAccountLabels

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

Wyświetla listę etykiet należących do konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji 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 sekcji OAuth 2.0 Overview.

AccountsService

Usługa do zarządzania informacjami o koncie usługi porównywania cen lub Merchant Center.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Pobiera pojedyncze konto usługi porównywania cen lub Merchant Center według identyfikatora.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.
ListChildAccounts

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

Wyświetla wszystkie konta pod określonym identyfikatorem konta usługi porównywania cen i opcjonalnie filtruje je 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 sekcji OAuth 2.0 Overview.
UpdateLabels

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

Aktualizuje etykiety przypisane do kont CSS/MC przez domenę usługi porównywania cen.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

CssProductInputsService

Usługa, która ma używać zasobu CssProductInput. Ta usługa pomaga wstawiać, aktualizować i usuwać produkty usługi porównywania cen.

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

Usuwa dane wejściowe produktu CSS z konta CSS Center.

Po usunięciu może minąć kilka minut, zanim dane wejściowe przestaną być dostępne.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.
InsertCssProductInput

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

Przesyła obiekt CssProductInput na konto CSS Center. Jeśli dane wejściowe o tym samym języku treści, tożsamości, etykiecie pliku danych i identyfikatorze pliku danych już istnieją, ta metoda zastępuje ten wpis.

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 sekcji OAuth 2.0 Overview.
UpdateCssProductInput

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

Aktualizuje istniejące dane wejściowe produktu usługi 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 dostępny.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

CssProductsService

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

GetCssProduct

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.
ListCssProducts

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

Zawiera listę przetworzonych produktów 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 sprawdzić, czy jest więcej elementów do pobrania.

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

QuotaService

Usługa do pobierania informacji o limicie wywołań metody dla każdej metody interfejsu CSS API.

ListQuotaGroups

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

Zawiera listę dziennego limitu wywołań i wykorzystania w poszczególnych grupach na koncie CSS Center.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

Konto

Informacje o koncie usługi porównywania cen lub Merchant Center.

Pola
name

string

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

string

Tylko dane wyjściowe. Niezmienna. Pełna nazwa konta CSS/MC.
label_ids[]

int64

Identyfikatory etykiet utworzone ręcznie i przypisane do konta usługi porównywania cen lub konta Merchant Center przez konto nadrzędne usługi porównywania cen.
automatic_label_ids[]

int64

Automatycznie utworzone identyfikatory etykiet 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 CSS lub MC.
homepage_uri

string

Tylko dane wyjściowe. Niezmienna. Strona główna konta usługi porównywania cen lub Merchant Center.
parent

string

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

AccountType

Rodzaj 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 Główne konto MCA w usłudze porównywania cen w Merchant Center.
MC_CSS_MCA Konto MCA usługi porównywania cen w Merchant Center.
MC_MARKETPLACE_MCA Konto MCA na platformie handlowej MC.
MC_OTHER_MCA Konto MC Other MCA.
MC_STANDALONE samodzielne konto MC.
MC_MCA_SUBACCOUNT subkonto MC MCA.

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: accounts/{account}/labels/{label}
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 dla 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 w nagłówku produktu w usłudze porównywania cen.
headline_offer_shipping_price

Price

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

string

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

string

Krój produktu. Można go używać do przedstawiania połączonych rodzajów rozmiarów w przypadku odzieży. Możesz podać maksymalnie 2 rodzaje rozmiarów (patrz rodzaj rozmiaru).
product_details[]

ProductDetail

Dane techniczne lub dodatkowe szczegóły produktu.
product_weight

ProductWeight

Waga produktu w podanych jednostkach. Wartość musi się mieścić w przedziale 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 przedziale od 0 (wykluczając tę wartość) do 3000 (włącznie).
product_width

ProductDimension

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

ProductDimension

Wysokość produktu w podanych jednostkach. Wartość musi mieścić się w przedziale 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 wygaśnięcia produktu określona podczas wstawiania w formacie ISO 8601. Rzeczywista data wygaśnięcia jest podana 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 kwota rat do zapłacenia za produkt.
headline_offer_subscription_cost

HeadlineOfferSubscriptionCost

Liczba okresów (miesięcy lub lat) i kwota płatności za okres w przypadku produktu z powiązaną umową subskrypcji.
cpp_ads_redirect

string

Umożliwia reklamodawcom zastąpienie adresu URL produktu, gdy jest on wyświetlany w kontekście reklam produktowych.
number_of_offers

int64

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

string

Stan oferty w nagłówku.
title

string

Nazwa produktu.
description

string

Opis produktu.
brand

string

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

string

Numer katalogowy producenta (MPN) produktu.
gtin

string

Globalny Numer Jednostki Handlowej (GTIN) produktu.
google_product_category

string

Kategoria produktu według Google (patrz mapa kategorii Google). Podczas wysyłania zapytań o produkty to pole będzie zawierać wartość podaną przez użytkownika. Obecnie nie ma możliwości uzyskania automatycznie przypisanych kategorii produktów Google za pomocą interfejsu API.
adult

bool

Ustaw wartość „true”, jeśli produkt jest przeznaczony dla dorosłych.
multipack

int64

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

bool

Informacja o tym, 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 dany produkt.
color

string

Kolor produktu.
gender

string

Płeć, dla której przeznaczony jest produkt.
material

string

Materiał, z którego wykonano produkt.
pattern

string

Wzór produktu (np. kropki).
size

string

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

string

System, w którym określony jest rozmiar. Zalecany w przypadku produktów odzieżowych.
item_group_id

string

Wspólny identyfikator wszystkich wersji tego samego produktu.
pause

string

Publikowanie tej pozycji zostanie tymczasowo wstrzymane.
custom_label_0

string

Etykieta własna 0 do niestandardowego grupowania produktów w kampanii produktowej.
custom_label_1

string

Etykieta własna 1 do niestandardowego grupowania produktów w kampanii produktowej.
custom_label_2

string

Etykieta własna 2 do niestandardowego grupowania produktów w kampanii produktowej.
custom_label_3

string

Etykieta własna 3 do niestandardowego grupowania produktów w kampanii produktowej.
custom_label_4

string

Etykieta własna 4 do niestandardowego grupowania produktów w kampanii produktowej.
review_count

int64

Liczba opinii o produkcie. Wymagane, jeśli podano rating. To pole jest przeznaczone dla przyszłej funkcji i nie jest jeszcze używane.
min_rating

int64

Minimalna ocena produktu. Wymagane, jeśli podano rating. To pole jest przeznaczone dla przyszłej funkcji i nie jest jeszcze używane.
max_rating

int64

Maksymalna ocena produktu. Wymagane, jeśli podano rating. To pole jest przeznaczone dla przyszłej funkcji i nie jest jeszcze używane.
rating

double

Średnia ocena produktu. Wartość musi się mieścić w przedziale [min_rating, max_rating] (włącznie). Gdy ocena jest wyświetlana na stronie produktu, jest normalizowana do skali [1, 5] z 1 miejscem po przecinku. Jeśli są podane, wymagane są też wartości review_count, min_rating i max_rating. To pole jest przeznaczone dla przyszłej funkcji i nie jest jeszcze używane.

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ęstsza wartość to „EC” lub „European_Commission” dla etykiet energetycznych w UE.
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 wywołanie 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 pierwotny produktu.
content_language

string

Tylko dane wyjściowe. Dwuliterowy kod języka produktu w standardzie ISO 639-1.
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 (dostarczonych przez CSS). Można go też używać 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óre nie są bezpośrednio udostępniane przez interfejs API, np. dodatkowych atrybutów używanych w Kup przez Google.
css_product_status

CssProductStatus

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

CssProductInput

Ten zasób reprezentuje dane wejściowe przesyłane dla produktu w usłudze porównywania cen, a nie przetworzony produkt w usłudze porównywania cen, który widzisz w CSS Center, reklamach produktowych lub w przestrzeni Google.

Pola
name

string

Identyfikator. Nazwa danych wejściowych produktu 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 produktu CSS. Dotyczy to zarówno danych wejściowych produktu w usłudze porównywania cen, jak i przetworzonego produktu w usłudze porównywania cen. Dozwolone są tylko identyfikatory zawierające znaki alfanumeryczne, podkreślenia i myślniki. Szczegółowe informacje znajdziesz w specyfikacji pliku danych o produktach.
content_language

string

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

string

Wymagane. Etykieta pliku danych dla produktu w usłudze porównywania cen. Etykieta pliku danych jest synonimem „kraju docelowego”, dlatego zawsze powinna być prawidłowym kodem regionu. Na przykład „DE” w przypadku Niemiec i „FR” w przypadku Francji.
freshness_time
(deprecated)

Timestamp

WYCOFANO. Zamiast tego użyj atrybutu expiration_date. Reprezentuje istniejącą wersję (aktualność) produktu w usłudze porównywania cen, która może być używana do zachowania właściwej kolejności, gdy wiele aktualizacji jest wykonywanych w tym samym czasie.

To pole nie może być ustawione na czas w przyszłości.

Jeśli ta opcja jest ustawiona, aktualizacja jest blokowana, jeśli w naszym systemie istnieje już nowsza wersja produktu (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 aktualizacja nastąpi, czas ostatniej aktualizacji zostanie ustawiony na ten czas odświeżania.

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

Jeśli operacja zostanie zablokowana, zostanie zgłoszony wyjątek aborted.
attributes

Attributes

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

CustomAttribute

Lista atrybutów niestandardowych (dostarczonych przez CSS). Można go też używać 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óre nie są bezpośrednio udostępniane przez interfejs API, np. dodatkowych atrybutów używanych w Kup przez Google.

CssProductStatus

Stan produktu w usłudze porównywania cen, problemy z weryfikacją danych, czyli informacje o produkcie w usłudze porównywania cen obliczane asynchronicznie.

Pola
destination_statuses[]

DestinationStatus

Miejsca docelowe, w których produkt ma być wyświetlany.
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 produktu w formacie ISO 8601.
google_expiration_date

Timestamp

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

DestinationStatus

Stan miejsca docelowego stanu produktu.

Pola
destination

string

Nazwa miejsca docelowego
approved_countries[]

string

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

string

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

string

Lista kodów krajów (ISO 3166-1 alpha-2), w których produkt CSS został odrzucony.

ItemLevelIssue

ItemLevelIssue stanu 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

Nazwa atrybutu, jeśli problem jest spowodowany przez jeden 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óry pomoże rozwiązać ten problem.
applicable_countries[]

string

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

DeleteAccountLabelRequest

Wiadomość z prośbą o wywołanie metody „DeleteAccountLabel”.

Pola
name

string

Wymagane. Nazwa etykiety do usunięcia. Format: accounts/{account}/labels/{label}

DeleteCssProductInputRequest

Wiadomość z prośbą o usunięcie produktu CSS.

Pola
name

string

Wymagane. Nazwa zasobu wejściowego produktu w usłudze porównywania cen do usunięcia. 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. Tego pola nie można ustawić, jeśli działanie dotyczy podstawowego pliku danych. Jeśli to pole jest ustawione, działanie dotyczące produktu jest stosowane do dodatkowego pliku danych zamiast do podstawowego pliku danych Content API.

GetAccountRequest

Wiadomość żądania dla metody GetAccount.

Pola
name

string

Wymagane. Nazwa zarządzanego konta CSS lub MC. 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ść żądania dla metody GetCssProduct.

Pola
name

string

Wymagane. Nazwa produktu usługi porównywania cen do pobrania. Format: accounts/{account}/cssProducts/{css_product}

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 zadatku, którą kupujący musi zapłacić z góry.

HeadlineOfferSubscriptionCost

SubscriptionCost produktu.

Pola
period

SubscriptionPeriod

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

int64

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

Price

Kwota, którą kupujący musi zapłacić za okres subskrypcji.

InsertCssProductInputRequest

Wiadomość z żądaniem dla metody InsertCssProductInput.

Pola
parent

string

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

CssProductInput

Wymagane. Dane wejściowe produktu CSS do wstawienia.
feed_id
(deprecated)

int64

Opcjonalnie. WYCOFANO. 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

Wiadomość z żądaniem 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 zostanie podana, zwracanych będzie maksymalnie 50 etykiet. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
page_token

string

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

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

ListAccountLabelsResponse

Wiadomość odpowiedzi dla metody ListAccountLabels.

Pola
account_labels[]

AccountLabel

Etykiety z określonego 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ść żądania dla 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 podano tego argumentu, zwracanych jest maksymalnie 50 kont. Maksymalna wartość to 100. Wartości powyżej 100 zostaną przekształcone w 100.
page_token

string

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

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

int64

Jeśli ta opcja jest ustawiona, zwracane są tylko konta MC z podanym identyfikatorem etykiety.
full_name

string

Jeśli ten parametr jest ustawiony, zwracane są tylko konta MC o podanej nazwie (z uwzględnieniem wielkości liter).

ListChildAccountsResponse

Wiadomość odpowiedzi dla metody ListChildAccounts.

Pola
accounts[]

Account

Konta usługi porównywania cen lub Merchant Center zwrócone 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

Komunikat żądania dla metody ListCssProducts.

Pola
parent

string

Wymagane. Konto lub domena, w których mają być wyświetlane przetworzone produkty w usłudze porównywania cen. Format: accounts/{account}
page_size

int32

Maksymalna liczba produktów usług porównywania cen do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000. Jeśli nie zostanie podana, zostanie zwrócona maksymalna liczba produktów usługi porównywania cen.
page_token

string

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

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

ListCssProductsResponse

Wiadomość odpowiedzi dla metody ListCssProducts.

Pola
css_products[]

CssProduct

Przetworzone produkty usługi porównywania cen z określonego 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

Wiadomość z prośbą o wywołanie metody ListQuotaGroups.

Pola
parent

string

Wymagane. Konto usługi porównywania cen, które jest właścicielem puli 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 stronicowania. Domyślna wartość to 500. Wartości powyżej 1000 zostaną zmienione na 1000.
page_token

string

Opcjonalnie. Token (jeśli jest dostępny) do pobrania następnej strony. Wszystkie pozostałe parametry muszą być zgodne z pierwotnym wywołaniem, które dostarczyło token strony.

ListQuotaGroupsResponse

Wiadomość odpowiedzi dla metody ListMethodGroups.

Pola
quota_groups[]

QuotaGroup

Metody, bieżące wykorzystanie limitu i limity dla każdej grupy. Limit jest wspólny dla wszystkich metod w grupie. Grupy są posortowane w kolejności malejącej 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 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 API, 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 używany do grupowania zestawu szczegółów produktu.
attribute_name

string

Nazwa szczegółu produktu.
attribute_value

string

Wartość szczegółu produktu.

ProductDimension

Wymiar produktu.

Pola
value

double

Wymagane. Wartość wymiaru przedstawiona jako liczba. Wartość może mieć maksymalnie 4 miejsca po przecinku.
unit

string

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

ProductWeight

Waga produktu.

Pola
value

double

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

string

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

QuotaGroup

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

Pola
name

string

Identyfikator. Nazwa zasobu grupy limitów. Format: accounts/{account}/quotas/{group} Przykład: accounts/12345678/quotas/css-products-insert Uwaga: część {group} nie musi mieć określonego wzorca.
quota_usage

int64

Tylko dane wyjściowe. Aktualne wykorzystanie limitu, czyli liczba wywołań wykonanych już w danym dniu w przypadku metod w grupie. Dzienne limity są resetowane o 12:00 UTC.
quota_limit

int64

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

int64

Tylko dane wyjściowe. Maksymalna liczba wywołań dozwolonych w ciągu minuty w przypadku grupy.
method_details[]

MethodDetails

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

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

Wiadomość z żądaniem dla metody UpdateAccountLabel.

Pola
account_label

AccountLabel

Wymagane. Zaktualizowana etykieta. Wszystkie pola muszą być wypełnione.

UpdateAccountLabelsRequest

Wiadomość żądania dla metody UpdateLabels.

Pola
name

string

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

int64

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

string

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

UpdateCssProductInputRequest

Wiadomość z żądaniem dla metody UpdateCssProductInput.

Pola
css_product_input

CssProductInput

Wymagane. Zasób danych wejściowych produktu w usłudze porównywania cen do zaktualizowania. 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, jest traktowana jako domniemana maska pola równoważna wszystkim polom, które są wypełnione (mają niepustą wartość).

Atrybuty określone w masce aktualizacji bez wartości określonej w treści zostaną usunięte z produktu CSS.

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

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

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