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 pierwotny 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 (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

object (CssProductStatus)

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

Atrybuty

Atrybuty dla 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 przedstawiania połączonych rodzajów rozmiarów w przypadku odzieży. Możesz podać maksymalnie 2 rodzaje rozmiarów (patrz rodzaj rozmiaru).
productDetails[]

object (ProductDetail)

Dane techniczne lub dodatkowe szczegóły produktu.
productWeight

object (ProductWeight)

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

object (ProductDimension)

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

object (ProductDimension)

Wysokość produktu w podanych jednostkach. Wartość musi mieścić się w przedziale 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 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.
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 kwota rat do zapłacenia 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ą subskrypcji.
cppAdsRedirect

string

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

string (int64 format)

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

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

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

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

Informacja o tym, 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 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)).
sizeSystem

string

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

string

Wspólny identyfikator wszystkich wersji tego samego produktu.
pause

string

Publikowanie tej pozycji zostanie tymczasowo wstrzymane.
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. To pole jest przeznaczone dla przyszłej funkcji i nie jest jeszcze używane.
minRating

string (int64 format)

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

string (int64 format)

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

number

Średnia ocena produktu. Wartość musi się mieścić w przedziale [minRating, maxRating] (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 reviewCount, minRating i maxRating. To pole jest przeznaczone dla przyszłej funkcji i nie jest jeszcze używane.

Cena

Cena w postaci liczby i waluty.

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

string (int64 format)

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

string

Waluta, w której podano cenę, przedstawiona w 3-literowym formacie 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 w postaci liczby. 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 przedstawiona 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ę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.

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

HeadlineOfferSubscriptionCost

SubscriptionCost 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 kupujący musi 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. Dokładnie jeden z tych 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 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 produkt ma być wyświetlany.
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 produkt CSS jest zatwierdzony.
pendingCountries[]

string

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

string

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

ItemLevelIssue

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

string

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

Metody

get

 Pobiera przetworzony produkt CSS z konta CSS Center.

list

 Zawiera listę przetworzonych produktów w usłudze porównywania cen na Twoim koncie CSS Center.