REST Resource: accounts.products

Zasób: Product

Przetworzony produkt utworzony na podstawie wielu [danych wejściowych produktu][[google.shopping.content.bundles.Products.ProductInput] po zastosowaniu reguł i dodatkowych źródeł danych. Ten przetworzony produkt jest zgodny z informacjami wyświetlanymi na Twoim koncie Merchant Center, w reklamach produktowych i innych miejscach w Google. Każdy produkt powstaje na podstawie dokładnie 1 źródła danych wejściowych produktu oraz kilku dodatkowych źródeł danych. Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu może minąć kilka minut, zanim będzie można pobrać zaktualizowany produkt.

Wszystkie pola w przetwarzanym produkcie i jego wiadomościach podrzędnych są zgodne z nazwą odpowiedniego atrybutu w specyfikacji danych produktów, z kilkoma wyjątkami.

Zapis JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Pola
name

string

Nazwa produktu. Format: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Tylko dane wyjściowe. Kanał produktu.
offerId

string

Tylko dane wyjściowe. Unikalny identyfikator produktu. To samo dotyczy danych wejściowych produktu i przetworzonego produktu. Odstępy na początku i na końcu są usuwane, a wiele odstępów jest zastępowanych pojedynczą spacją podczas przesyłania. Więcej informacji znajdziesz w specyfikacji danych produktów.
contentLanguage

string

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

string

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

string

Tylko dane wyjściowe. Podstawowe źródło danych produktu.
attributes

object (Attributes)

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

object (CustomAttribute)

Tylko dane wyjściowe. Lista niestandardowych atrybutów (dostarczonych przez sprzedawcę). Za pomocą tego atrybutu można też przesłać dowolny atrybut specyfikacji danych w ogólnej formie (np. { "name": "size type", "value": "regular" }). Jest to przydatne w przypadku przesyłania atrybutów, które nie są wyraźnie widoczne przez interfejs API, takich jak dodatkowe atrybuty używane w usłudze Kup przez Google.
productStatus

object (ProductStatus)

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

string (int64 format)

Tylko dane wyjściowe. Reprezentuje istniejącą wersję (aktualność) produktu, która pozwala zachować właściwą kolejność w przypadku przeprowadzania wielu aktualizacji jednocześnie.

Jeśli jest ustawiony, wstawianie jest blokowane, gdy numer wersji jest niższy niż bieżący numer wersji istniejącego produktu. Ponowne wstawienie (na przykład odświeżenie produktu po 30 dniach) można wykonać za pomocą obecnej wartości versionNumber.

Obsługiwane tylko w przypadku wstawiania do podstawowych źródeł danych.

Jeśli ta operacja jest blokowana, zgłaszany jest przerwany wyjątek.

Atrybuty

Atrybuty.

Zapis JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Pola
expirationDate

string (Timestamp format)

Data ważności produktu podana w formacie ISO 8601 podana przy wstawieniu. Rzeczywista data ważności jest wyświetlana w productstatuses jako googleExpirationDate. Może być wcześniejsza, jeśli expirationDate jest w zbyt odległej przyszłości.
disclosureDate

string (Timestamp format)

Data, kiedy oferta staje się widoczna w wynikach wyszukiwania w usługach YouTube, podana w formacie ISO 8601. Więcej informacji znajdziesz w sekcji [Data ujawnienia]( https://support.google.com/merchants/answer/13034208).
availabilityDate

string (Timestamp format)

Dzień, kiedy będzie możliwa dostawa produktu zamówionego w przedsprzedaży, podany w formacie ISO 8601.
price

object (Price)

Cena produktu.
installment

object (Installment)

Liczba i kwota rat do zapłacenia za produkt.
subscriptionCost

object (SubscriptionCost)

Liczba okresów (miesięcy lub lat) i kwota płatności w danym okresie za produkt z powiązaną umową subskrypcyjną.
loyaltyPoints

object (LoyaltyPoints)

Punkty lojalnościowe przyznawane użytkownikom po zakupie produktu. Tylko Japonia.
loyaltyPrograms[]

object (LoyaltyProgram)

Lista informacji o programie lojalnościowym, które służą do wyświetlania użytkownikowi tego produktu korzyści z programu lojalnościowego (np. lepsza cena, punkty itp.).
productTypes[]

string

Kategorie produktu (w formacie zgodnym ze specyfikacją danych produktów).
salePrice

object (Price)

Reklamowana cena promocyjna produktu.
salePriceEffectiveDate

object (Interval)

Zakres dat, w którym produkt jest oferowany po obniżonej cenie (zobacz specyfikację danych produktów).
productHeight

object (ProductDimension)

Wysokość produktu w podanych jednostkach. Wartość musi znajdować się w zakresie od 0 (bez uwzględnienia) do 3000 (włącznie).
productLength

object (ProductDimension)

Długość produktu w podanych jednostkach. Wartość musi znajdować się w zakresie od 0 (bez uwzględnienia) do 3000 (włącznie).
productWidth

object (ProductDimension)

Szerokość produktu w podanych jednostkach. Wartość musi znajdować się w zakresie od 0 (bez uwzględnienia) do 3000 (włącznie).
productWeight

object (ProductWeight)

Waga produktu w podanych jednostkach. Wartość musi znajdować się w zakresie od 0 (bez uwzględnienia) do 2000 (włącznie).
shipping[]

object (Shipping)

Zasady dostawy.
freeShippingThreshold[]

object (FreeShippingThreshold)

Warunki, które muszą zostać spełnione, aby produkt miał bezpłatną dostawę.
shippingWeight

object (ShippingWeight)

Waga wysyłanego produktu.
shippingLength

object (ShippingDimension)

Długość produktu przeznaczonego do wysyłki.
shippingWidth

object (ShippingDimension)

Szerokość produktu przeznaczonego do wysyłki.
shippingHeight

object (ShippingDimension)

Wysokość wysyłanego produktu.
sizeTypes[]

string

Krój produktu. Możesz go użyć do przedstawienia typów połączonych rozmiarów w przypadku produktów odzieżowych. Możesz podać maksymalnie 2 rodzaje rozmiarów (zobacz [https://support.google.com/merchants/answer/6324497](typ rozmiaru)).
taxes[]

object (Tax)

Dane podatnika.
unitPricingMeasure

object (UnitPricingMeasure)

Miara i wymiar produktu.
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

Preferowany mianownik ceny jednostkowej.
adsLabels[]

string

Podobna do grupowania reklam, ale działa tylko w modelu CPC.
costOfGoodsSold

object (Price)

Koszt własny sprzedaży. Służy do raportowania zysków brutto.
productDetails[]

object (ProductDetail)

Specyfikacja techniczna lub dodatkowe szczegóły produktu.
productHighlights[]

string

Listy punktowane opisujące najważniejsze cechy produktu.
displayAdsSimilarIds[]

string

Rekomendacje określone przez reklamodawcę.
promotionIds[]

string

Unikalny identyfikator promocji.
includedDestinations[]

string

Lista miejsc docelowych do uwzględnienia w przypadku tego miejsca docelowego (odpowiada zaznaczonym polom wyboru w Merchant Center). Domyślne miejsca docelowe są zawsze uwzględniane, chyba że zostały podane w zasadzie excludedDestinations.
excludedDestinations[]

string

Lista miejsc docelowych do wykluczenia w przypadku tego celu (odpowiada niezaznaczonym polom wyboru w Merchant Center).
shoppingAdsExcludedCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), aby wykluczyć ofertę z miejsca docelowego w reklamach produktowych. Kraje z tej listy są usuwane z krajów skonfigurowanych w ustawieniach źródła danych.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

Dodatkowe pola do wyeksportowania do programu Cloud Retail.
certifications[]

object (Certification)

certyfikaty dotyczące produktów, na przykład certyfikaty efektywności energetycznej produktów zarejestrowane w bazie danych EPREL Unii Europejskiej; Więcej informacji znajdziesz w artykule w Centrum pomocy.
autoPricingMinPrice

object (Price)

Środki ochrony w projektach „Rabaty automatyczne” (https://support.google.com/merchants/answer/10295759) i „Dynamiczne promocje” (https://support.google.com/merchants/answer/13949249). Zagwarantuje, że rabaty na oferty sprzedawców nie będą niższe niż ta wartość. Pozwoli to zachować wartość i dochodowość oferty.
identifierExists

boolean

Ustaw tę wartość na „false”, jeśli produkt nie ma unikalnych identyfikatorów produktów odpowiednich dla jego kategorii, takich jak numer GTIN, MPN lub marka. Jeśli nie zostanie podana, domyślna wartość to prawda.
isBundle

boolean

Informacja, czy produkt jest pakietem przygotowanym przez sprzedawcę. Pakiet to niestandardowa grupa różnych produktów sprzedawanych przez sprzedawcę w jednej cenie.
title

string

Tytuł produktu.
description

string

Opis produktu.
adult

boolean

Jeśli produkt jest kierowany do dorosłych, ustaw wartość „true” (prawda).
ageGroup

string

Docelowa grupa wiekowa elementu.
availability

string

Stan dostępności produktu.
brand

string

Marka produktu.
color

string

Kolor produktu.
condition

string

Stan lub stan produktu.
gender

string

Docelowa płeć produktu.
googleProductCategory

string

Kategoria Google produktu (patrz Mapa kategorii Google). W przypadku wysyłania zapytań dotyczących produktów to pole będzie zawierać wartość podaną przez użytkownika. Obecnie nie można za pomocą interfejsu API przywrócić automatycznie przypisanych kategorii produktów Google.
gtin

string

Globalny numer jednostki handlowej (GTIN) produktu.
itemGroupId

string

Wspólny identyfikator wszystkich wersji tego samego produktu.
material

string

Materiał, z którego wykonano produkt.
mpn

string

Numer katalogowy produktu (MPN).
pattern

string

Wzór produktu (np. grochy).
sellOnGoogleQuantity

string (int64 format)

Liczba produktów dostępnych do sprzedaży w Google. Obsługiwane tylko w przypadku produktów online.
maxHandlingTime

string (int64 format)

Maksymalny czas obsługi produktu (w dniach roboczych).
minHandlingTime

string (int64 format)

Minimalny czas obsługi zamówienia (w dniach roboczych).
shippingLabel

string

Etykieta wysyłki produktu służąca do grupowania produktu w regułach dostawy na poziomie konta.
transitTimeLabel

string

Etykieta czasu przewozu produktu używana do grupowania produktów w tabelach czasu przewozu na poziomie konta.
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ą itemGroupId (zobacz [https://support.google.com/merchants/answer/6324492](definicja rozmiaru)).
sizeSystem

string

System, w którym określa się rozmiar. Zalecany w przypadku produktów odzieżowych.
taxCategory

string

Kategoria podatkowa produktu używana do konfigurowania szczegółowego zakładu podatkowego w ustawieniach podatków na poziomie konta.
energyEfficiencyClass

string

Klasa efektywności energetycznej zdefiniowana w dyrektywie UE 2010/30/UE.
minEnergyEfficiencyClass

string

Klasa efektywności energetycznej zdefiniowana w dyrektywie UE 2010/30/UE.
maxEnergyEfficiencyClass

string

Klasa efektywności energetycznej zdefiniowana w dyrektywie UE 2010/30/UE.
multipack

string (int64 format)

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

string

Służy do grupowania elementów w dowolny sposób. Tylko w przypadku CPA%; niezalecane.
adsRedirect

string

Pozwala reklamodawcom zastąpić adres URL produktu, gdy produkt jest wyświetlany w kontekście reklam produktów.
displayAdsId

string

Identyfikator produktu w kampaniach remarketingu dynamicznego.
displayAdsTitle

string

Tytuł produktu w kampaniach remarketingu dynamicznego.
displayAdsValue

number

Marża ofertowa dla kampanii remarketingu dynamicznego.
pickupMethod

string

Opcja odbioru produktu.
pickupSla

string

Oś czasu odbioru produktu w sklepie.
customLabel0

string

Etykieta własna 0 – niestandardowe grupowanie elementów w kampanii produktowej.
customLabel1

string

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

string

Etykieta własna 2 – niestandardowe grupowanie produktów w kampanii produktowej.
customLabel3

string

Etykieta własna 3 – niestandardowe grupowanie produktów w kampanii produktowej.
customLabel4

string

Etykieta własna 4 – niestandardowe grupowanie elementów w kampanii produktowej.
externalSellerId

string

Wymagane w przypadku kont wielu sprzedawców. Użyj tego atrybutu, jeśli zarządzasz platformą handlową, aby przesyłać produkty różnych sprzedawców na konto wielu sprzedawców.
pause

string

Publikowanie tego elementu zostanie tymczasowo wstrzymane.
structuredTitle

object (ProductStructuredTitle)

Tytuł uporządkowany w przypadku tytułów generowanych przez algorytm (AI).
structuredDescription

object (ProductStructuredDescription)

Opis uporządkowany do opisów generowanych przez algorytm (AI).

Rata

Komunikat reprezentujący ratę.

Zapis JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
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ą musi zapłacić kupujący.
creditType

string

Typ płatności ratalnej. Obsługiwane wartości to: * „finance” * „lease”

SubscriptionCost

Koszt abonamentu 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 subskrypcji, które kupujący musi zapłacić.
amount

object (Price)

Kwota, jaką kupujący musi zapłacić za okres subskrypcji.

SubscriptionPeriod

Okres subskrypcji usługi.

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.

LoyaltyPoints

Komunikat reprezentujący punkty lojalnościowe.

Zapis JSON 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
Pola
name

string

Nazwa programu punktów lojalnościowych. Zalecamy ograniczenie nazwy do 12 znaków o pełnej szerokości lub 24 znaków alfabetu łacińskiego.
pointsValue

string (int64 format)

Wartość bezwzględna liczby punktów lojalnościowych przyznawanych przez sprzedawcę.
ratio

number

Współczynnik służący do przeliczania punktów na pieniądze. Przyjmuje się, że waluta stosowana do przeliczania punktów jest zgodna z ustawieniami w Merchant Center. Jeśli współczynnik nie jest podany, przyjmuje się wartość domyślną 1,0.

LoyaltyProgram

Komunikat reprezentujący program lojalnościowy.

Zapis JSON 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Pola
programLabel

string

Etykieta programu lojalnościowego. To jest etykieta wewnętrzna, która jednoznacznie identyfikuje relację między sprzedawcą a podmiotem uczestniczącym w programie lojalnościowym. Musisz ją podać, aby system mógł powiązać poniższe zasoby (np. cenę i punkty) ze sprzedawcą. Odpowiedni program musi być połączony z kontem sprzedawcy.
tierLabel

string

Etykieta poziomu w programie lojalnościowym. Musi pasować do jednej z etykiet w programie.
price

object (Price)

Cena dla uczestników danego poziomu, czyli natychmiastowa obniżona cena. Musi być mniejsza od ceny standardowej lub jej równa.
cashbackForFutureUse

object (Price)

Zwrot za zakupy, który można wykorzystać na przyszłe zakupy.
loyaltyPoints

string (int64 format)

Liczba punktów lojalnościowych zdobytych za zakup.

ProductDimension

Wymiar produktu.

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

number

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

string

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

ProductWeight

Waga produktu.

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

number

Wymagane. Waga przedstawiana jako liczba. Waga może mieć maksymalnie cztery miejsca po przecinku.
unit

string

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

Dostawa

Dostawa produktu.

Zapis JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Pola
price

object (Price)

Stała cena dostawy w postaci liczby.
country

string

Kod regionu CLDR odpowiadający krajowi, do którego zostanie wysłany produkt.
region

string

Region geograficzny, do którego odnosi się koszt dostawy. Aby dowiedzieć się więcej, sprawdź region.
service

string

Swobodny opis klasy usługi lub szybkości dostarczania.
locationId

string (int64 format)

Identyfikator numeryczny lokalizacji, do której odnosi się koszt dostawy, jak określono w interfejsie API AdWords.
locationGroupName

string

Lokalizacja, w której możliwa jest dostawa, reprezentowana przez nazwę grupy lokalizacji.
postalCode

string

Zakres kodów pocztowych, do którego odnosi się koszt dostawy, wyrażony za pomocą kodu pocztowego, prefiksu kodu pocztowego, po którym następuje symbol wieloznaczny *, zakresu od dwóch kodów pocztowych lub dwóch prefiksów kodu o takiej samej długości.
minHandlingTime

string (int64 format)

Minimalny czas obsługi zamówienia (włącznie) od momentu otrzymania zamówienia do chwili wysłania go w ciągu dni roboczych. Wartość 0 oznacza, że zamówienie zostanie wysłane tego samego dnia, w którym je otrzymało, jeśli nastąpi to przed ostatecznym terminem ich dostawy. [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] będzie można podać tylko razem z wartością [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]. Nie będzie on jednak wymagany, jeśli podano parametr [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
maxHandlingTime

string (int64 format)

Maksymalny czas obsługi zamówienia (włącznie) od momentu otrzymania zamówienia do chwili wysłania go w ciągu dni roboczych. Wartość 0 oznacza, że zamówienie zostanie wysłane tego samego dnia, w którym je otrzymało, jeśli nastąpi to przed ostatecznym terminem ich dostawy. Jeśli podajesz szybkość dostawy, wymagany jest zarówno [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] i [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] będzie opcjonalny, jeśli podany zostanie atrybut [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
minTransitTime

string (int64 format)

Minimalny czas przewozu (włącznie) od momentu wysłania zamówienia do chwili dostarczenia go do klienta w ciągu dni roboczych. Wartość 0 oznacza, że zamówienie jest dostarczane tego samego dnia, w którym zostało wysłane. Wartość [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] może wystąpić tylko w połączeniu z wartością [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. Nie jest ona jednak wymagana, jeśli podano wartość [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].
maxTransitTime

string (int64 format)

Maksymalny czas przewozu (włącznie) od momentu wysłania zamówienia do chwili dostarczenia go do klienta w ciągu dni roboczych. Wartość 0 oznacza, że zamówienie jest dostarczane tego samego dnia, w którym zostało wysłane. Jeśli podajesz szybkość dostawy, wymagany jest zarówno [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] i [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. Wartość [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] jest opcjonalna, jeśli podano wartość [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].

FreeShippingThreshold

Warunki, które muszą zostać spełnione, aby produkt miał bezpłatną dostawę.

Zapis JSON 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
Pola
country

string

Kod regionu CLDR odpowiadający krajowi, do którego zostanie wysłany produkt.
priceThreshold

object (Price)

Minimalna cena produktu, po której koszty dostawy staną się bezpłatne. Liczebność.

ShippingWeight

Waga przesyłki z produktem.

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

number

Waga produktu, która służy do obliczenia kosztów jego dostawy.
unit

string

Jednostka wartości.

ShippingDimension

ShippingDimensions produktu.

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

number

Wymiar produktu, który służy do obliczenia kosztów jego dostawy.
unit

string

Jednostka wartości.

Podatek

Podatek od produktu.

Zapis JSON 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
Pola
rate

number

Procent stawki podatku, która ma zastosowanie do ceny produktu.
country

string

Kraj, w którym produkt jest opodatkowany, określony za pomocą kodu regionu CLDR.
region

string

Region geograficzny, w którym obowiązuje stawka podatku.
taxShip

boolean

Ustaw wartość Prawda, jeśli podatek jest naliczany od dostawy.
locationId

string (int64 format)

Identyfikator numeryczny lokalizacji, do której odnosi się stawka podatku, jak określono w interfejsie API AdWords.
postalCode

string

Zakres kodów pocztowych, do którego odnosi się stawka podatku, wyrażony za pomocą kodu pocztowego, prefiksu kodu pocztowego oznaczonego symbolem *, zakresu od dwóch kodów pocztowych lub dwóch prefiksów kodu o takiej samej długości. Przykłady: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingMeasure

Wartość UnitPricingMeasure produktu.

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

number

Miara produktu.
unit

string

Jednostka miary.

UnitPricingBaseMeasure

Wartość UnitPricingBaseMeasure produktu.

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

string (int64 format)

Mianownik ceny jednostkowej.
unit

string

Jednostka mianownika.

ProductDetail

Szczegóły produktu.

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

string

Nagłówek sekcji służący do grupowania zestawu szczegółów produktu.
attributeName

string

Nazwa szczegółów produktu.
attributeValue

string

Wartość szczegółów produktu.

CloudExportAdditionalProperties

Właściwość usługi w Cloud Retail API. Przykładowo właściwościami produktu telewizyjnego mogą być „Rozdzielczość ekranu” lub „Rozmiar ekranu”.

Zapis JSON 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
Pola
textValue[]

string

Wartość tekstowa danej właściwości. Na przykład „8K(UHD)” może być wartością tekstową dotyczącą telewizora. Maksymalna powtórzenie tej wartości wynosi 400. Wartości są przechowywane w dowolnej, ale spójnej kolejności. Maksymalny rozmiar ciągu to 256 znaków.
intValue[]

string (int64 format)

Liczba całkowita danej właściwości. Na przykład 1080 w przypadku rozdzielczości ekranu telewizora. Maksymalna powtórzenie tej wartości wynosi 400. Wartości są przechowywane w dowolnej, ale spójnej kolejności.
floatValue[]

number

Wartości zmiennoprzecinkowe danej właściwości. Na przykład telewizor 1.2345. Maksymalna powtórzenie tej wartości wynosi 400. Wartości są przechowywane w dowolnej, ale spójnej kolejności.
propertyName

string

Nazwa danej usługi. Przykład: „Rozdzielczość ekranu” w przypadku telewizora. Maksymalny rozmiar ciągu to 256 znaków.
boolValue

boolean

Wartość logiczna danej właściwości. Na przykład w przypadku telewizora będzie widoczna wartość „True” lub „False”, jeśli ekran będzie w jakości UHD.
minValue

number

Minimalna wartość zmiennoprzecinkowa danej właściwości. Na przykład telewizor 1.00.
maxValue

number

Maksymalna wartość zmiennoprzecinkowa danej właściwości. Na przykład w przypadku telewizora o wartości 100,00.
unitCode

string

Jednostka danej właściwości. Na przykład „Pixele” w przypadku telewizora. Maksymalny rozmiar ciągu znaków to 256 B.

Certyfikat

Certyfikat produktu, wprowadzony w celu zapewnienia zgodności z unijnymi certyfikatami efektywności energetycznej produktów za pomocą bazy danych EPREL UE.

Zapis JSON 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
Pola
certificationAuthority

string

Urząd certyfikacji, na przykład „European_Commission”. Maksymalna długość to 2000 znaków.
certificationName

string

Nazwa certyfikatu, na przykład „EPREL”. Maksymalna długość to 2000 znaków.
certificationCode

string

Kod certyfikatu. Maksymalna długość to 2000 znaków.
certificationValue

string

Wartość certyfikatu (inaczej: klasa, poziom lub stopień), na przykład „A+”, „C”, „złoto”. Maksymalna długość to 2000 znaków.

ProductStructuredTitle

Tytuł uporządkowany w przypadku tytułów generowanych przez algorytm (AI).

Zapis JSON 
{
  "digitalSourceType": string,
  "content": string
}
Pola
digitalSourceType

string

Typ źródła cyfrowego, np. „training_algorithmic_media”. Obserwujesz IPTC. Maksymalna długość to 40 znaków.
content

string

Tekst tytułu Maksymalna długość to 150 znaków

ProductStructuredDescription

Opis uporządkowany do opisów generowanych przez algorytm (AI).

Zapis JSON 
{
  "digitalSourceType": string,
  "content": string
}
Pola
digitalSourceType

string

Typ źródła cyfrowego, np. „training_algorithmic_media”. Obserwujesz IPTC. Maksymalna długość to 40 znaków.
content

string

Tekst opisu Maksymalna długość to 5000 znaków.

ProductStatus

Stan produktu, problemy z weryfikacją danych, czyli informacje o produkcie obliczone asynchronicznie.

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

object (DestinationStatus)

Zamierzone miejsca docelowe produktu.
itemLevelIssues[]

object (ItemLevelIssue)

Lista wszystkich problemów z usługą.
creationDate

string (Timestamp format)

Data utworzenia elementu podana w formacie ISO 8601.
lastUpdateDate

string (Timestamp format)

Data ostatniej aktualizacji produktu podana w formacie ISO 8601.
googleExpirationDate

string (Timestamp format)

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

DestinationStatus

Stan miejsca docelowego stanu produktu.

Zapis JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Pola
reportingContext

enum (ReportingContextEnum)

Nazwa kontekstu raportowania.
approvedCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których oferta jest zatwierdzona.
pendingCountries[]

string

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

string

Lista kodów krajów (ISO 3166-1 alfa-2), w których oferta została odrzucona.

ItemLevelIssue

Wartość elementu ItemLevelIssue stanu produktu.

Zapis JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Pola
code

string

Kod błędu, którego dotyczy problem.
severity

enum (Severity)

Jak ten problem wpływa na wyświetlanie oferty.
resolution

string

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

string

Nazwa atrybutu, jeśli problem jest spowodowany przez jeden atrybut.
reportingContext

enum (ReportingContextEnum)

Kontekst raportowania, 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 ma pomóc w rozwiązaniu tego problemu.
applicableCountries[]

string

Lista kodów krajów (ISO 3166-1 alfa-2), w przypadku których oferta dotyczy problemu.

Poziom ważności

Jak problem wpływa na wyświetlanie produktu.

Wartości w polu enum
SEVERITY_UNSPECIFIED Nie określono.
NOT_IMPACTED Ten problem stanowi ostrzeżenie i nie ma bezpośredniego wpływu na produkt.
DEMOTED Produkt ma obniżoną pozycję, co najprawdopodobniej ma ograniczoną skuteczność w wynikach wyszukiwania
DISAPPROVED Problem powoduje odrzucenie produktu.

Metody

get

 Pobiera przetworzony produkt z Twojego konta Merchant Center.

list

 Zawiera listę przetworzonych produktów na koncie Merchant Center.