Package google.shopping.merchant.products.v1beta

Indeks

ProductInputsService

Usługa wykorzystująca zasób ProductInput. Ta usługa dotyczy tylko produktów z kanałem online.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

Usuwa dane produktu z konta Merchant Center.

Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu może minąć kilka minut, zanim będzie możliwe pobranie przetworzonego produktu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Przesyła dane o produktach na Twoje konto Merchant Center. Jeśli dane wejściowe o tych samych parametrach contentLanguage, offerId i dataSource już istnieją, ta metoda zastępuje ten wpis.

Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu może minąć kilka minut, zanim będzie możliwe pobranie przetworzonego produktu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ProductsService

Usługa do korzystania z zasobu produktu. Ta usługa dotyczy tylko produktów z kanałem online.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

Pobiera przetworzony produkt z Twojego konta Merchant 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 artykule Omówienie protokołu OAuth 2.0.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Zawiera listę przetworzonych produktów na koncie Merchant Center. Odpowiedź może zawierać mniej elementów niż określona przez wartość pageSize. Polecenie pageToken pozwala określić, czy można żądać więcej elementów.

Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu może minąć kilka minut, zanim będzie można pobrać zaktualizowany produkt.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

Atrybuty

Atrybuty.

Pola
expiration_date

Timestamp

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

Timestamp

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

Timestamp

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

Price

Cena produktu.
installment

Installment

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

SubscriptionCost

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

LoyaltyPoints

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

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.).
product_types[]

string

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

Price

Reklamowana cena promocyjna produktu.
sale_price_effective_date

Interval

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

ProductDimension

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

ProductDimension

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

ProductDimension

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

ProductWeight

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

Shipping

Zasady dostawy.
free_shipping_threshold[]

FreeShippingThreshold

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

ShippingWeight

Waga wysyłanego produktu.
shipping_length

ShippingDimension

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

ShippingDimension

Szerokość produktu przeznaczonego do wysyłki.
shipping_height

ShippingDimension

Wysokość wysyłanego produktu.
size_types[]

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

Tax

Dane podatnika.
unit_pricing_measure

UnitPricingMeasure

Miara i wymiar produktu.
unit_pricing_base_measure

UnitPricingBaseMeasure

Preferowany mianownik ceny jednostkowej.
ads_labels[]

string

Podobny do parametru ads_grouping, ale działa tylko w przypadku określania stawek CPC.
cost_of_goods_sold

Price

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

ProductDetail

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

string

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

string

Rekomendacje określone przez reklamodawcę.
promotion_ids[]

string

Unikalny identyfikator promocji.
included_destinations[]

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

string

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

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

CloudExportAdditionalProperties

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

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

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

bool

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

bool

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

bool

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

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

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

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

int64

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

int64

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

int64

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

string

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

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

string

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

string

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

string

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

string

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

string

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

int64

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

string

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

string

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

string

Identyfikator produktu w kampaniach remarketingu dynamicznego.
display_ads_title

string

Tytuł produktu w kampaniach remarketingu dynamicznego.
display_ads_value

double

Marża ofertowa dla kampanii remarketingu dynamicznego.
pickup_method

string

Opcja odbioru produktu.
pickup_sla

string

Oś czasu odbioru produktu w sklepie.
custom_label_0

string

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

string

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

string

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

string

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

string

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

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

ProductStructuredTitle

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

ProductStructuredDescription

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

Certyfikat

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

Pola
certification_authority

string

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

string

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

string

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

string

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

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

Pola
text_value[]

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

int64

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

float

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

string

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

bool

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

float

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

float

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

string

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

DeleteProductInputRequest

Komunikat żądania dotyczący metody DeleteProductInput.

Pola
name

string

Wymagane. Nazwa zasobu wejściowego produktu do usunięcia. Format: accounts/{konto}/productInputs/{product}
data_source

string

Wymagane. Podstawowe lub dodatkowe źródło danych, z którego należy usunąć dane wejściowe o produktach. Format: accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

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

Pola
country

string

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

Price

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

GetProductRequest

Komunikat żądania dla metody GetProduct.

Pola
name

string

Wymagane. Nazwa produktu do pobrania. Format: accounts/{account}/products/{product}

InsertProductInputRequest

Komunikat żądania dla metody InsertProductInput.

Pola
parent

string

Wymagane. Konto, na którym chcesz wstawić ten produkt. Format: konta/{konto}
product_input

ProductInput

Wymagane. Dane wejściowe produktu do wstawienia.
data_source

string

Wymagane. Nazwa podstawowego lub dodatkowego źródła danych produktów. Jeśli produkt już istnieje, a podane źródło danych jest inne, produkt zostanie przeniesiony do nowego źródła danych. Format: accounts/{account}/dataSources/{datasource}.

Rata

Komunikat reprezentujący ratę.

Pola
months

int64

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

Price

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

Price

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

string

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

ListProductsRequest

Komunikat żądania metody ListProducts.

Pola
parent

string

Wymagane. Konto, dla którego ma się wyświetlać lista produktów przetworzonych. Format: konta/{konto}
page_size

int32

Maksymalna liczba produktów do zwrotu. 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 określono inaczej, zostanie zwrócona maksymalna liczba produktów.
page_token

string

Token strony otrzymany z poprzedniego wywołania funkcji ListProducts. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListProducts muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListProductsResponse

Komunikat odpowiedzi dla metody ListProducts.

Pola
products[]

Product

Przetworzone produkty z określonego konta. Są to produkty przetworzone po zastosowaniu reguł i dodatkowych źródeł danych.
next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

LoyaltyPoints

Komunikat reprezentujący punkty lojalnościowe.

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

int64

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

double

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.

Pola
program_label

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

string

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

Price

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

Price

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

int64

Liczba punktów lojalnościowych zdobytych za zakup.

Produkt

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.

Pola
name

string

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

ChannelEnum

Tylko dane wyjściowe. Kanał produktu.
offer_id

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

string

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

string

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

string

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

Attributes

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

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

ProductStatus

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

int64

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

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

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

ProductDetail

Szczegóły produktu.

Pola
section_name

string

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

string

Nazwa szczegółów produktu.
attribute_value

string

Wartość szczegółów produktu.

ProductDimension

Wymiar produktu.

Pola
value

double

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”

ProductInput

Ten zasób reprezentuje dane wejściowe, które przesyłasz dotyczące produktu, a nie produktu przetworzonego, który widzisz w Merchant Center, w reklamach produktowych lub w usługach Google. Dane wejściowe produktu, reguły i dodatkowe dane źródeł danych są łączone w celu utworzenia przetworzonego atrybutu [product][google.shopping.content.bundles.Products.Product].

Wymagane atrybuty wejściowe produktów, które umożliwiają weryfikację danych, są przede wszystkim zdefiniowane w specyfikacji danych produktów.

Wymagane są te atrybuty: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] i [offerId][google.shopping.content.bundles.Products.offer_id].

Po wstawieniu, zaktualizowaniu lub usunięciu danych wejściowych produktu może minąć kilka minut, zanim będzie możliwe pobranie przetworzonego produktu.

Wszystkie pola w danych wejściowych produktu i jego wiadomościach podrzędnych są zgodne z angielską nazwą odpowiedniego atrybutu w specyfikacji branży (z pewnymi wyjątkami).

Pola
name

string

Identyfikator. Nazwa danych wejściowych o produkcie. Format: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

Tylko dane wyjściowe. Nazwa przetworzonego produktu. Format: "{product.name=accounts/{account}/products/{product}}"
channel

ChannelEnum

Wymagane. Stała. Kanał produktu.
offer_id

string

Wymagane. Stała. 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.
content_language

string

Wymagane. Stała. Dwuliterowy kod języka ISO 639-1.
feed_label

string

Wymagane. Stała. Etykieta pliku danych produktu.
attributes

Attributes

Opcjonalnie. Lista atrybutów produktów.
custom_attributes[]

CustomAttribute

Opcjonalnie. Lista niestandardowych atrybutów (dostarczonych przez sprzedawcę). Można go również wykorzystać do przesyłania dowolnych atrybutów 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. Maksymalna dozwolona liczba znaków dla każdego atrybutu niestandardowego to 10 240 (reprezentuje sumę znaków nazwy i wartości). Dla każdego produktu można ustawić maksymalnie 2500 atrybutów niestandardowych o łącznym rozmiarze 102, 4 kB. Podkreślenia w nazwach atrybutów niestandardowych są zastępowane spacjami podczas ich wstawiania.
version_number

int64

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

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

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

ProductStatus

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

Pola
destination_statuses[]

DestinationStatus

Zamierzone miejsca docelowe produktu.
item_level_issues[]

ItemLevelIssue

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

Timestamp

Data utworzenia elementu podana w formacie ISO 8601.
last_update_date

Timestamp

Data ostatniej aktualizacji produktu podana w formacie ISO 8601.
google_expiration_date

Timestamp

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

DestinationStatus

Stan miejsca docelowego stanu produktu.

Pola
reporting_context

ReportingContextEnum

Nazwa kontekstu raportowania.
approved_countries[]

string

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

string

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

string

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

ItemLevelIssue

Wartość elementu ItemLevelIssue stanu produktu.

Pola
code

string

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

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

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

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.

ProductStructuredDescription

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

Pola
digital_source_type

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.

ProductStructuredTitle

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

Pola
digital_source_type

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

ProductWeight

Waga produktu.

Pola
value

double

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.

Pola
price

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

int64

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

string

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

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

int64

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].
max_handling_time

int64

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].
min_transit_time

int64

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].
max_transit_time

int64

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

ShippingDimension

ShippingDimensions produktu.

Pola
value

double

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

string

Jednostka wartości.

ShippingWeight

Waga przesyłki z produktem.

Pola
value

double

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

string

Jednostka wartości.

SubscriptionCost

Koszt abonamentu produktu.

Pola
period

SubscriptionPeriod

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

int64

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

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.

Podatek

Podatek od produktu.

Pola
rate

double

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

bool

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

int64

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

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

UnitPricingBaseMeasure

Wartość UnitPricingBaseMeasure produktu.

Pola
value

int64

Mianownik ceny jednostkowej.
unit

string

Jednostka mianownika.

UnitPricingMeasure

Wartość UnitPricingMeasure produktu.

Pola
value

double

Miara produktu.
unit

string

Jednostka miary.