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 usługi porównywania cen. Format: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

Tylko dane wyjściowe. Unikalny identyfikator produktu.
contentLanguage

string

Tylko dane wyjściowe. Dwuliterowy kod języka ISO 639-1 produktu.
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 (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.
cssProductStatus

object (CssProductStatus)

Tylko dane wyjściowe. stan produktu, problemy z weryfikacją danych, czyli informacje o produkcie obliczone 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
}
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 produktu w usłudze porównywania cen w nagłówku.
headlineOfferShippingPrice

object (Price)

Cena produktu w usłudze porównywania cen w nagłówku.
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 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)).
productDetails[]

object (ProductDetail)

Dane techniczne lub dodatkowe informacje o produkcie.
productWeight

object (ProductWeight)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

string

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

object (Certification)

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

string (Timestamp format)

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.
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 podano je w polu excludedDestinations.
excludedDestinations[]

string

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

object (HeadlineOfferInstallment)

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

object (HeadlineOfferSubscriptionCost)

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

string

Umożliwia reklamodawcom zastąpienie adresu URL produktu, gdy produkt jest wyświetlany w kontekście reklamy produktowej.
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 (MPN) produktu.
gtin

string

Globalny Numer Jednostki Handlowej (GTIN) produktu.
googleProductCategory

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

boolean

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

string (int64 format)

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

boolean

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

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)).
sizeSystem

string

System, w którym podano 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 służąca do niestandardowego grupowania produktów w kampanii produktowej.
customLabel1

string

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

string

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

string

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

string

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

Cena

Cena podana jako liczba i waluta.

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

string (int64 format)

Cena podana jako liczba w mikrojednostkach (1 mln mikrojednostek odpowiada 1 jednostce standardowej waluty, np. 1 USD = 1000000 mikrojednostek).
currencyCode

string

Waluta, w której podano cenę, przedstawiona w trzyliterowym formacie ISO 4217.

ProductDetail

Szczegóły produktu.

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

string

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

string

Nazwa szczegółów produktu.
attributeValue

string

Wartość szczegółów produktu.

ProductWeight

Waga produktu.

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

number

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”

ProductDimension

Wymiar produktu.

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

number

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”

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

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 do zapłacenia przez kupującego.
downpayment

object (Price)

Kwota wpłaty wstępnej, 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: * month * year
periodLength

string (int64 format)

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

object (Price)

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

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 zawierający atrybuty niestandardowe. Dokładnie jeden z atrybutów value lub groupValues nie może być pusty.

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 usługi porównywania cen, problemy z weryfikacją danych, czyli informacje o usłudze porównywania cen obliczone asynchronicznie.

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

object (DestinationStatus)

Przeznaczenie produktu.
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 elementu w formacie ISO 8601.
googleExpirationDate

string (Timestamp format)

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

DestinationStatus

Stan docelowy 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 alpha-2), w których produkt jest zatwierdzony.
pendingCountries[]

string

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

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.

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.
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.
applicableCountries[]

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.

Metody

get

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

list

 Wyświetla przetworzone produkty w usłudze porównywania cen na Twoim koncie CSS Center.