REST Resource: accounts.cssProducts

Zasób: CssProduct

Przetworzony produkt w usłudze porównywania cen.

Zapis JSON 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Pola
name

string

Nazwa produktu w usłudze porównywania cen. Format: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

Tylko dane wyjściowe. Unikalny nieprzetworzony identyfikator produktu.
contentLanguage

string

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

string

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

object (Attributes)

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

object (CustomAttribute)

Tylko dane wyjściowe. Lista atrybutów niestandardowych (podanych przez usługę porównywania cen). 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 do przesyłania atrybutów, które nie są bezpośrednio udostępniane przez interfejs API, takich jak dodatkowe atrybuty używane w usłudze Kup przez Google.
cssProductStatus

object (CssProductStatus)

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

Atrybuty

Atrybuty produktu w usłudze porównywania cen.

Zapis JSON 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
Pola
lowPrice

object (Price)

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

object (Price)

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

object (Price)

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

object (Price)

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

string

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

string

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

object (ProductDetail)

Dane techniczne lub dodatkowe szczegóły produktu.
productWeight

object (ProductWeight)

Waga produktu w podanych jednostkach. Wartość musi się zawierać w przedziale od 0 (wyłącznie) do 2000 (włącznie).
productLength

object (ProductDimension)

Długość produktu w podanych jednostkach. Wartość musi się mieścić w przedziale od 0 (wyłącznie) do 3000 (włącznie).
productWidth

object (ProductDimension)

Szerokość produktu w podanych jednostkach. Wartość musi się mieścić w przedziale od 0 (wyłącznie) do 3000 (włącznie).
productHeight

object (ProductDimension)

Wysokość produktu w podanych jednostkach. Wartość musi się mieścić w przedziale od 0 (wyłącznie) do 3000 (włącznie).
productHighlights[]

string

Punkty opisujące najważniejsze cechy produktu.
certifications[]

object (Certification)

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

string (Timestamp format)

Data, kiedy produkt powinien wygasnąć, określona podczas wstawiania, w formacie ISO 8601. Rzeczywista data ważności jest podana w polu productstatuses jako googleExpirationDate i może być wcześniejsza, jeśli wartość expirationDate przypada w zbyt odległej przyszłości. Uwaga: usunięcie elementu może potrwać ponad 2 dni od daty ważności.
includedDestinations[]

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 określono je w polu excludedDestinations.

Obsługiwane wartości: - css_ads_experiences - css_organic_experiences
excludedDestinations[]

string

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

Obsługiwane wartości: - css_ads_experiences - css_organic_experiences
headlineOfferInstallment

object (HeadlineOfferInstallment)

Liczba i kwota rat do zapłaty za produkt.
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

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

string

Umożliwia reklamodawcom zastąpienie adresu URL produktu, gdy produkt jest wyświetlany w kontekście reklam produktów.
numberOfOffers

string (int64 format)

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

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 producenta (MPN) produktu.
gtin

string

Globalny numer jednostki handlowej (GTIN) produktu.
googleProductCategory

string

Kategoria produktu 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 odzyskania automatycznie przypisanych kategorii produktów Google za pomocą interfejsu API.
adult

boolean

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

string (int64 format)

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

boolean

Czy produkt jest pakietem utworzonym przez sprzedawcę. Pakiet to niestandardowa grupa różnych produktów sprzedawanych przez sprzedawcę w jednej cenie.
ageGroup

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 o różnych rozmiarach dodaj osobny produkt dla każdego rozmiaru z tą samą wartością itemGroupId (zobacz [https://support.google.com/merchants/answer/6324492](definicja rozmiaru)).
sizeSystem

string

System, w którym określono rozmiar. Zalecany w przypadku produktów odzieżowych.
itemGroupId

string

Wspólny identyfikator wszystkich wersji tego samego produktu.
pause

string

Publikacja tego elementu zostanie tymczasowo wstrzymana.
customLabel0

string

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

string

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

string

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

string

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

string

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

string (int64 format)

Liczba opinii o produkcie. Wymagane, jeśli podano rating.
minRating

string (int64 format)

Minimalna ocena produktu. Wymagane, jeśli podano rating.
maxRating

string (int64 format)

Maksymalna ocena produktu. Wymagane, jeśli podano rating.
rating

number

Średnia ocena produktu. Wartość musi się mieścić w zakresie [minRating, maxRating] (włącznie). Gdy ocena jest wyświetlana na stronie produktu, jest normalizowana do skali [1, 5] z jednym miejscem po przecinku. Jeśli podasz tę wartość, wymagane są też wartości reviewCount, minRating i maxRating.

Cena

Cena podana jako liczba i waluta.

Zapis JSON 
{
  "amountMicros": string,
  "currencyCode": string
}
Pola
amountMicros

string (int64 format)

Cena wyrażona jako liczba w mikrojednostkach (1 milion mikrojednostek odpowiada standardowej jednostce waluty, np. 1 USD = 1 000 000 mikrojednostek).
currencyCode

string

Waluta, w której podano cenę, przedstawiona w trzyliterowym formacie zgodnym z normą ISO 4217.

ProductDetail

szczegóły produktu,

Zapis JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Pola
sectionName

string

Nagłówek sekcji używany do grupowania zestawu szczegółów produktu.
attributeName

string

Nazwa szczegółu produktu.
attributeValue

string

Wartość szczegółu produktu.

ProductWeight

Waga produktu.

Zapis JSON 
{
  "value": number,
  "unit": string
}
Pola
value

number

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

string

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

ProductDimension

Wymiar produktu.

Zapis JSON 
{
  "value": number,
  "unit": string
}
Pola
value

number

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

string

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

Certyfikat

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

Zapis JSON 
{
  "name": string,
  "authority": string,
  "code": string
}
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ą jest „EC” lub „European_Commission” w przypadku 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.

HeadlineOfferInstallment

Wiadomość reprezentująca ratę.

Zapis JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
Pola
months

string (int64 format)

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

object (Price)

Miesięczna kwota, którą kupujący musi zapłacić.
downpayment

object (Price)

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

HeadlineOfferSubscriptionCost

Koszt subskrypcji produktu.

Zapis JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Pola
period

enum (SubscriptionPeriod)

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

string (int64 format)

Liczba okresów abonamentowych, które osoba kupująca jest zobowiązana opłacić.
amount

object (Price)

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

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.

CustomAttribute

Komunikat reprezentujący atrybuty niestandardowe. Jedna z tych wartości nie może być pusta: value lub groupValues.

Zapis JSON 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Pola
groupValues[]

object (CustomAttribute)

Atrybuty podrzędne w tej grupie atrybutów. Jeśli pole groupValues nie jest puste, pole value musi być puste.
name

string

Nazwa atrybutu.
value

string

Wartość atrybutu. Jeśli pole value nie jest puste, pole groupValues musi być puste.

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.

Zapis JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Pola
destinationStatuses[]

object (DestinationStatus)

Miejsca docelowe, w których ma się wyświetlać produkt.
itemLevelIssues[]

object (ItemLevelIssue)

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

string (Timestamp format)

Data utworzenia elementu w formacie ISO 8601.
lastUpdateDate

string (Timestamp format)

Data ostatniej aktualizacji produktu w formacie ISO 8601.
googleExpirationDate

string (Timestamp format)

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

DestinationStatus

Stan miejsca docelowego stanu produktu.

Zapis JSON 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Pola
destination

string

Nazwa miejsca docelowego
approvedCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których usługa porównywania cen jest zatwierdzona.
pendingCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których usługa porównywania cen oczekuje na zatwierdzenie.
disapprovedCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których usługa porównywania cen jest odrzucona.

ItemLevelIssue

Problem na poziomie produktu dotyczący stanu produktu.

Zapis JSON 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Pola
code

string

Kod błędu problemu.
servability

string

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

string

czy sprzedawca może rozwiązać problem;
attribute

string

Nazwa 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óry pomoże rozwiązać ten problem.
applicableCountries[]

string

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

Metody

get

 Pobiera przetworzony produkt w usłudze porównywania cen z konta CSS Center.

list

 Wyświetla listę przetworzonych produktów w usłudze porównywania cen na koncie CSS Center.