Package google.shopping.merchant.products.v1beta

Indeks

ProductInputsService

Usługa korzystająca z zasobu ProductInput. Ta usługa działa tylko w przypadku 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 produktu może minąć kilka minut, zanim przetworzony produkt będzie można pobrać.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Przesyła dane produktu na konto Merchant Center. Jeśli dane o tych samych wartościach w kolumnach contentLanguage, offerId i dataSource już istnieją, ta metoda zastąpi te wpisy.

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

ProductsService

Usługa korzystająca z zasobu Product. Ta usługa działa tylko w przypadku produktów z kanałem online.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

Pobiera przetworzony produkt z konta Merchant Center.

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Wyświetla przetworzone produkty na koncie Merchant Center. Odpowiedź może zawierać mniej elementów niż określono w parametrze pageSize. Użyj parametru pageToken, aby określić, czy są jeszcze inne elementy, których możesz zażądać.

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

Atrybuty

Atrybuty.

Pola
expiration_date

Timestamp

Data, w której element ma wygasnąć, określona podczas jego dodania w formacie ISO 8601. Rzeczywista data wygaśnięcia jest widoczna w polu productstatuses jako googleExpirationDate i może być wcześniejsza, jeśli data expirationDate jest zbyt odległa.
disclosure_date

Timestamp

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

Timestamp

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

string

Globalne numery jednostek handlowych (GTIN) produktu. Możesz podać maksymalnie 10 numerów GTIN.
price

Price

Cena produktu.
installment

Installment

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

SubscriptionCost

Liczba okresów (miesięcy lub lat) i kwota płatności za okres dla produktu z powiązanym abonamentem.
loyalty_points

LoyaltyPoints

Punkty lojalnościowe, które użytkownicy otrzymują po zakupie produktu. Tylko Japonia.
loyalty_programs[]

LoyaltyProgram

Lista informacji o programie lojalnościowym, która jest używana do wyświetlania korzyści związanych z programem lojalnościowym (np. lepszych cen, punktów itp.) użytkownikowi tego produktu.
product_types[]

string

Kategorie produktu (sformatowane zgodnie ze specyfikacją danych produktów).
sale_price

Price

Reklamowana obniżona cena produktu.
sale_price_effective_date

Interval

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

ProductDimension

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

ProductDimension

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

ProductDimension

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

ProductWeight

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

Shipping

Reguły dostawy.
free_shipping_threshold[]

FreeShippingThreshold

Warunki, które należy spełnić, aby produkt kwalifikował się do bezpłatnej dostawy.
shipping_weight

ShippingWeight

Waga produktu do wysyłki.
shipping_length

ShippingDimension

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

ShippingDimension

Szerokość produktu na potrzeby dostawy.
shipping_height

ShippingDimension

Wysokość produktu na potrzeby dostawy.
size_types[]

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 rodzaje rozmiarów (patrz [https://support.google.com/merchants/answer/6324497](rodzaj rozmiaru)).
taxes[]

Tax

dane podatnika,
unit_pricing_measure

UnitPricingMeasure

Miara i wielkość produktu.
unit_pricing_base_measure

UnitPricingBaseMeasure

Preferowany mianownik ceny jednostkowej.
ads_labels[]

string

Podobne do ads_grouping, ale działa tylko w przypadku CPC.
cost_of_goods_sold

Price

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

ProductDetail

Dane techniczne lub dodatkowe informacje o produkcie.
product_highlights[]

string

Punkty opisujące najważniejsze informacje o produkcie.
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 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.
excluded_destinations[]

string

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

string

Lista kodów krajów (ISO 3166-1 alpha-2), aby wykluczyć ofertę z miejsca docelowego reklam produktowych. Kraje z tej listy są usuwane z listy 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 produktów, np. certyfikaty efektywności energetycznej produktów zarejestrowanych w bazie danych EPREL Unii Europejskiej. Więcej informacji znajdziesz w Centrum pomocy.
auto_pricing_min_price

Price

Zabezpieczenie w ramach projektów „Automatyczne rabaty” (https://support.google.com/merchants/answer/10295759) i „Promocje dynamiczne” (https://support.google.com/merchants/answer/13949249), które zapewniają, że rabaty na oferty sprzedawców nie spadną poniżej tej wartości, co pozwala zachować wartość i rentowność oferty.
sustainability_incentives[]

ProductSustainabilityIncentive

Lista programów zachęt do promowania zrównoważonego rozwoju.
identifier_exists

bool

Ustaw tę wartość jako fałsz, gdy produkt nie ma unikalnych identyfikatorów produktów odpowiednich dla jego kategorii, takich jak GTIN, MPN i marka. Jeśli nie zostanie podany, domyślnie ma wartość „true”.
is_bundle

bool

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

string

Tytuł produktu.
description

string

Opis produktu.
adult

bool

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

string

Docelowa grupa wiekowa, dla której jest przeznaczony produkt.
availability

string

Stan dostępności produktu.
brand

string

Marka produktu.
color

string

Kolor produktu.
condition

string

Stan produktu.
gender

string

Docelowa płeć klientów, dla których jest przeznaczony produkt.
google_product_category

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

string

Wspólny identyfikator wszystkich wersji tego samego produktu.
material

string

Materiał, z którego wykonano produkt.
mpn

string

Numer katalogowy (MPN) produktu.
pattern

string

Wzór produktu (np. kropki).
sell_on_google_quantity

int64

Ilość produktu, która jest dostępna do sprzedaży w Google. Obsługiwane tylko w przypadku produktów dostępnych online.
max_handling_time

int64

Maksymalny czas obsługi zamówienia (w dniach roboczych).
min_handling_time

int64

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

string

Etykieta wysyłki produktu, która służy do grupowania produktów w regułach dostawy na poziomie konta.
transit_time_label

string

Etykieta czasu przewozu produktu, która służy do grupowania produktów w tabelach czasu przewozu na poziomie konta.
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)).
size_system

string

System, w którym podano rozmiar. Zalecany w przypadku produktów odzieżowych.
tax_category

string

Kategoria podatkowa produktu.
energy_efficiency_class

string

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

string

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

string

Klasa efektywności energetycznej określona 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 produktów w dowolny sposób. Tylko w przypadku CPA%, nie zalecane w innych przypadkach.
ads_redirect

string

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

Czas, w którym produkt jest dostępny do odbioru w sklepie
custom_label_0

string

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

string

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

string

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

string

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

string

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

string

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

string

Publikacja tego elementu zostanie tymczasowo wstrzymana.
structured_title

ProductStructuredTitle

Tytuł strukturalny – w przypadku tytułów wygenerowanych algorytmicznie (AI).
structured_description

ProductStructuredDescription

atrybut opis strukturalny – w przypadku opisów wygenerowanych algorytmicznie (AI).

Certyfikat

Certyfikat produktu, który początkowo został wprowadzony w celu zapewnienia zgodności z etykietami efektywności energetycznej UE za pomocą bazy danych EPREL.

Pola
certification_authority

string

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

string

Nazwa certyfikatu, np. „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 (zwana też klasą, poziomem lub oceną), np. „A+”, „C”, „złoty”. Maksymalna długość to 2000 znaków.

CloudExportAdditionalProperties

Właściwość produktu w Cloud Retail API. Właściwości w przypadku telewizora mogą na przykład mieć nazwy „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ą dla telewizora. Maksymalna powtarzalność tej wartości wynosi 400. Wartości są przechowywane w dowolnej, ale spójnej kolejności. Maksymalny rozmiar ciągu znaków to 256 znaków.
int_value[]

int64

Wartości liczb całkowitych danej właściwości. Na przykład 1080 w przypadku rozdzielczości ekranu telewizora. Maksymalna powtarzalność 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 w przypadku telewizora: 1.2345. Maksymalna powtarzalność tej wartości wynosi 400. Wartości są przechowywane w dowolnej, ale spójnej kolejności.
property_name

string

Nazwa danej właściwości. Na przykład „Rozdzielczość ekranu” w przypadku telewizora. Maksymalny rozmiar ciągu znaków to 256 znaków.
bool_value

bool

Wartość logiczna danej właściwości. Na przykład w przypadku telewizora wartość „True” lub „False”, jeśli ekran jest UHD.
min_value

float

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

float

Maksymalna wartość zmiennoprzecinkowa danej właściwości. Na przykład w przypadku telewizora 100.00.
unit_code

string

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

DeleteProductInputRequest

Komunikat z prośbą o wykonanie metody DeleteProductInput.

Pola
name

string

Wymagany. Nazwa zasobu wejściowego produktu, który chcesz usunąć. Format: accounts/{account}/productInputs/{product}, gdzie ostatnia sekcja product składa się z 4 części: channel~content_language~feed_label~offer_id. Przykład nazwy produktu to „accounts/123/productInputs/online~pl~PL~sku123”.
data_source

string

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

FreeShippingThreshold

Warunki, które należy spełnić, aby produkt kwalifikował się do bezpłatnej dostawy.

Pola
country

string

Kod regionu CLDR kraju, do którego wysyłany jest produkt.
price_threshold

Price

Minimalna cena produktu, aby koszt dostawy był bezpłatny. Jest reprezentowana jako liczba.

GetProductRequest

Wiadomość żądania dla metody GetProduct.

Pola
name

string

Wymagany. Nazwa produktu do pobrania. Format: accounts/{account}/products/{product}, gdzie ostatnia sekcja product składa się z 4 części: channel~content_language~feed_label~offer_id. Przykład nazwy produktu to „accounts/123/products/online~pl~PL~sku123”.

InsertProductInputRequest

wiadomość z prośbą o wykonanie metody InsertProductInput,

Pola
parent

string

Wymagany. Konto, na którym zostanie wstawiony produkt. Format: accounts/{account}
product_input

ProductInput

Wymagany. Dane produktu do wstawienia.
data_source

string

Wymagany. Nazwa podstawowego lub dodatkowego źródła danych o produktach. Jeśli produkt już istnieje, a podano inne źródło danych, produkt zostanie przeniesiony do nowego źródła danych.

Obsługiwane są tylko źródła danych w interfejsie API.

Format: accounts/{account}/dataSources/{datasource}.

Instalacja

Wiadomość reprezentująca ratę.

Pola
months

int64

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

Price

Miesięczna kwota do zapłacenia przez kupującego.
downpayment

Price

Kwota wpłaty wstępnej, którą kupujący musi zapłacić z góry.
credit_type

string

Typ płatności ratalnych. Obsługiwane wartości: * finance * lease

ListProductsRequest

wiadomość z prośbą o wyświetlenie listy produktów (metoda ListProducts).

Pola
parent

string

Wymagany. Konto, na którym mają być wyświetlane przetworzone produkty. Format: accounts/{account}
page_size

int32

Maksymalna liczba produktów do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Maksymalna wartość to 250; wartości powyżej 250 zostaną skonwertowane na 250. Jeśli nie określisz tej wartości, zwrócona zostanie maksymalna liczba produktów.
page_token

string

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

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListProducts muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListProductsResponse

wiadomość odpowiedzi dla metody ListProducts;

Pola
products[]

Product

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

string

token, który może być wysył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 lojalnościowego. Zalecamy ograniczenie nazwy do 12 znaków o pełnej szerokości lub 24 znaków alfabetu łacińskiego.
points_value

int64

Punkty lojalnościowe sprzedawcy w wartości bezwzględnej.
ratio

double

Współczynnik służący do przeliczania punktów na pieniądze. Google zakłada, że cena została podana w walucie kraju, w którym znajduje się sklep. Jeśli współczynnik nie zostanie podany, zostanie użyta wartość domyślna 1,0.

LoyaltyProgram

Komunikat przedstawiający program lojalnościowy.

Pola
program_label

string

Etykieta programu lojalnościowego. Jest to wewnętrzna etykieta, która jednoznacznie identyfikuje relację między elementem sprzedawcy a elementem programu lojalnościowego. Musisz podać etykietę, aby system mógł powiązać podane niżej zasoby (np. cenę i punkty) ze sprzedawcą. Odpowiednie programy muszą być połączone z kontem sprzedawcy.
tier_label

string

Etykieta poziomu w programie lojalnościowym. Musi być zgodna z jedną z etykietek w programie.
price

Price

Cena dla członków danego poziomu, czyli cena z natychmiastowym rabatem. Musi być mniejsza lub równa regularnej cenie.
cashback_for_future_use

Price

Środki, które można wykorzystać na przyszłe zakupy.
loyalty_points

int64

Liczba punktów lojalnościowych zdobytych za zakup.
member_price_effective_date

Interval

Zakres dat, w którym produkt kwalifikuje się do ceny dla członków. Jeśli nie jest określony, cena dla członków jest zawsze obowiązująca. Zakres dat jest reprezentowany przez parę dat w formacie ISO 8601 rozdzielonych spacjami, przecinkami lub ukośnikami.
shipping_label

string

Etykieta korzyści związanej z dostawą. Jeśli pole zawiera wartość, oznacza to, że oferta kwalifikuje się do korzyści związanych z dostawą w programie lojalnościowym. Jeśli wartość pola nie jest podana, produkt nie kwalifikuje się do dostawy w ramach programu lojalnościowego na danym poziomie.

Produkt

Przetworzony produkt, utworzony z wielu product inputs po zastosowaniu reguł i dodatkowych źródeł danych. Przetworzony produkt jest zgodny z informacjami wyświetlanymi na koncie Merchant Center oraz w reklamach produktowych i innych usługach Google. Każdy produkt jest tworzony na podstawie dokładnie jednego źródła danych podstawowego i wielu źródeł danych dodatkowych. Po wstawieniu, zaktualizowaniu lub usunięciu danych produktu może minąć kilka minut, zanim zaktualizowany przetworzony produkt będzie można pobrać.

Wszystkie pola przetworzonego produktu i jego komunikatów podrzędnych są zgodne z nazwą odpowiadającego atrybutu w specyfikacji danych produktów, z pewnymi wyjątkami.

Pola
name

string

Nazwa produktu. Format: "{product.name=accounts/{account}/products/{product}}", gdzie ostatnia sekcja product składa się z 4 części: channel~content_language~feed_label~offer_id. Przykład nazwy produktu to „accounts/123/products/online~pl~PL~sku123”.
channel

ChannelEnum

Tylko dane wyjściowe. Kanał produktu.
offer_id

string

Tylko dane wyjściowe. Unikalny identyfikator Twojego produktu. Dotyczy to zarówno danych wejściowych, jak i przetworzonego produktu. Odstępy na początku i na końcu ciągu są usuwane, a wielokrotne spacje są zastępowane pojedynczą spacją po przesłaniu. Szczegółowe informacje znajdziesz w specyfikacji danych produktów.
content_language

string

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

CustomAttribute

Tylko dane wyjściowe. Lista atrybutów niestandardowych (podanych przez sprzedawcę). Można go też użyć do przesłania dowolnego atrybutu specyfikacji danych w jego ogólnej formie (np. { "name": "size type", "value": "regular" }). Jest to przydatne w przypadku przesyłania atrybutów, które nie są jawnie udostępniane przez interfejs API, np. dodatkowych atrybutów używanych 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 bieżącą wersję (aktualność) produktu, która może służyć do zachowania prawidłowej kolejności, gdy wprowadzane są jednocześnie liczne aktualizacje.

Jeśli ta opcja jest ustawiona, wstawianie jest blokowane, gdy numer wersji jest niższy niż bieżący numer wersji danego produktu. Ponowna wstawka (np. odświeżenie produktu po 30 dniach) może zostać wykonana za pomocą bieżącego version_number.

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

Jeśli operacja zostanie zablokowana, zostanie wywołany wyjątek przerwania.

ProductDetail

Szczegóły produktu.

Pola
section_name

string

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

string

Nazwa szczegółów produktu.
attribute_value

string

Wartość szczegółów produktu.

ProductDimension

Wymiar produktu.

Pola
value

double

Wymagany. Wartość wymiaru w postaci liczby. Wartość może mieć maksymalnie 4 miejsca po przecinku.
unit

string

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

ProductInput

Ten zasób reprezentuje dane wejściowe przesłane przez Ciebie dla produktu, a nie przetworzony produkt, który widzisz w Merchant Center, w reklamach produktowych lub w przestrzeni Google. Dane wejściowe produktów, reguły i dane dodatkowego źródła danych są łączone, aby utworzyć przetworzone dane Product.

Wymagane atrybuty danych wejściowych produktów, które muszą przejść weryfikację danych, są zdefiniowane głównie w specyfikacji danych produktów.

Wymagane są te atrybuty: feedLabel, contentLanguage i offerId.

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

Wszystkie pola w danych produktu i jego komunikatach podrzędnych są zgodne z nazwą angielską odpowiadającego atrybutu w specyfikacji branżowej (z niektórymi wyjątkami).

Pola
name

string

Identyfikator. Nazwa danych wejściowych dotyczących produktu. Format: "{productinput.name=accounts/{account}/productInputs/{productinput}}", gdzie ostatnia sekcja productinput składa się z 4 części: channel~content_language~feed_label~offer_id. Przykład nazwy danych wejściowych produktu to „accounts/123/productInputs/online~pl~PL~sku123”.
product

string

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

ChannelEnum

Niezmienna. Kanał produktu.
offer_id

string

Wymagany. Niezmienna. Unikalny identyfikator Twojego produktu. Dotyczy to zarówno danych wejściowych, jak i przetworzonego produktu. Odstępy na początku i na końcu ciągu są usuwane, a wielokrotne spacje są zastępowane pojedynczą spacją po przesłaniu. Szczegółowe informacje znajdziesz w specyfikacji danych produktów.
content_language

string

Wymagany. Niezmienna. Dwuliterowy kod języka ISO 639-1 produktu.
feed_label

string

Wymagany. Niezmienna. Etykieta pliku danych produktu.
attributes

Attributes

Opcjonalnie: Lista atrybutów produktu.
custom_attributes[]

CustomAttribute

Opcjonalnie: Lista atrybutów niestandardowych (podanych przez sprzedawcę). Można go też używać do przesyłania dowolnego atrybutu specyfikacji danych w jego ogólnej formie (np. { "name": "size type", "value": "regular" }). Jest to przydatne w przypadku przesyłania atrybutów, które nie są jawnie udostępniane 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 10240 (co odpowiada sumie znaków w nazwie i wartości). Na produkt 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 wstawiania.
version_number

int64

Opcjonalnie: Reprezentuje bieżącą wersję (aktualność) produktu, która może służyć do zachowania prawidłowej kolejności, gdy wprowadzane są jednocześnie liczne aktualizacje.

Jeśli ta opcja jest ustawiona, wstawianie jest blokowane, gdy numer wersji jest niższy niż bieżący numer wersji danego produktu. Ponowna wstawka (np. odświeżenie produktu po 30 dniach) może zostać wykonana za pomocą bieżącego version_number.

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

Jeśli operacja zostanie zablokowana, zostanie wywołany wyjątek przerwania.

ProductStatus

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

Pola
destination_statuses[]

DestinationStatus

Przeznaczenie produktu.
item_level_issues[]

ItemLevelIssue

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

Timestamp

Data utworzenia elementu w formacie ISO 8601.
last_update_date

Timestamp

Data ostatniej aktualizacji elementu w formacie ISO 8601.
google_expiration_date

Timestamp

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

DestinationStatus

Stan docelowy 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 została 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

Stan produktu na poziomie produktu.

Pola
code

string

Kod błędu.
severity

Severity

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

string

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

string

nazwę atrybutu, jeśli problem jest spowodowany przez pojedynczy atrybut.
reporting_context

ReportingContextEnum

Kontekst raportowania, w którym występuje 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.
applicable_countries[]

string

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

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 jest ostrzeżeniem i nie ma bezpośredniego wpływu na produkt.
DEMOTED Produkt został zdegradowany i najprawdopodobniej ma ograniczoną skuteczność w wynikach wyszukiwania
DISAPPROVED Problem powoduje odrzucenie produktu.

ProductStructuredDescription

atrybut opis strukturalny – w przypadku opisów wygenerowanych algorytmicznie (AI).

Pola
digital_source_type

string

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

string

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

ProductStructuredTitle

Tytuł strukturalny – w przypadku tytułów wygenerowanych algorytmicznie (AI).

Pola
digital_source_type

string

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

string

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

ProductSustainabilityIncentive

informacje o programach motywacyjnych związanych ze zrównoważonym rozwojem, takich jak rabaty lub ulgi podatkowe;

Pola
Pole unii value. Wartość zachęty do zrównoważonego rozwoju. value może być tylko jednym z tych elementów:
amount

Price

Stała kwota zachęty.
percentage

double

Odsetek ceny sprzedaży, do której ma zastosowanie zachęta.
type

Type

Program motywacyjny dotyczący zrównoważonego rozwoju.

Typ

Typy obsługiwanych programów zachęt do zrównoważonego rozwoju.

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślony lub nieznany typ zachęty do zrównoważonego rozwoju.
EV_TAX_CREDIT Program oferujący ulgi podatkowe na pojazdy elektryczne, a w niektórych krajach także na hybrydy typu plug-in. Te rabaty mogą być wyrażone w określonej kwocie lub w procentach ceny sprzedaży.
EV_PRICE_DISCOUNT Program dotacji, często nazywany bonusem ekologicznym, zapewnia dotację na zakup pojazdów elektrycznych, a w niektórych krajach – hybrydowych typu plug-in. Kwota grantu może być kwotą stałą lub procentem ceny sprzedaży.

ProductWeight

Waga produktu.

Pola
value

double

Wymagany. Waga podana jako liczba. Waga może mieć maksymalnie 4 miejsca po przecinku.
unit

string

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

Dostawa

Dostawa produktu.

Pola
price

Price

Stałe koszty dostawy podane w postaci liczby.
country

string

Kod regionu CLDR kraju, do którego wysyłany jest produkt.
region

string

Region geograficzny, w którym obowiązuje stawka dostawy. Więcej informacji znajdziesz w regionie.
service

string

Wolny opis klasy usługi lub szybkości dostawy.
location_id

int64

Numeryczny identyfikator lokalizacji, do której ma zastosowanie stawka dostawy, zdefiniowany w interfejsie AdWords API.
location_group_name

string

Lokalizacja, w której obowiązuje dostawa, reprezentowana przez nazwę grupy lokalizacji.
postal_code

string

Zakres kodów pocztowych, do których ma zastosowanie stawka dostawy, reprezentowany przez kod pocztowy, prefiks kodu pocztowego z symbolem zastępczym *, zakres między dwoma kodami pocztowymi lub 2 prefiksami kodu pocztowego o jednakowej długości.
min_handling_time

int64

Minimalny czas obsługi zamówienia (w tym samym dniu) w dniach roboczych od momentu jego przyjęcia do wysyłki. 0 oznacza, że zamówienie jest wysyłane tego samego dnia, w którym zostało złożone, jeśli nastąpi to przed ostatecznym terminem. Wartość minHandlingTime może występować tylko razem z wartością maxHandlingTime, ale nie jest wymagana, jeśli występuje wartość maxHandlingTime.
max_handling_time

int64

Maksymalny czas obsługi zamówienia (w tym czasie) między jego złożeniem a wysłaniem w dniach roboczych. 0 oznacza, że zamówienie jest wysyłane tego samego dnia, w którym zostało złożone, jeśli nastąpi to przed ostatecznym terminem. Jeśli podajesz szybkość dostawy, wymagane są wartości maxHandlingTime i maxTransitTime. Właściwość minHandlingTime jest opcjonalna, jeśli występuje właściwość maxHandlingTime.
min_transit_time

int64

Minimalny czas przewozu (włącznie) między wysyłką zamówienia a jego dostarczeniem w dniach roboczych. Wartość 0 oznacza, że zamówienie jest dostarczane tego samego dnia, w którym zostało wysłane. Wartość minTransitTime może występować tylko razem z wartością maxTransitTime, ale nie jest wymagana, jeśli występuje wartość maxTransitTime.
max_transit_time

int64

Maksymalny czas przewozu (włącznie) między wysyłką zamówienia a jego dostarczeniem w dniach roboczych. Wartość 0 oznacza, że zamówienie jest dostarczane tego samego dnia, w którym zostało wysłane. Jeśli podajesz szybkość dostawy, wymagane są wartości maxHandlingTime i maxTransitTime. Właściwość minTransitTime jest opcjonalna, jeśli występuje właściwość maxTransitTime.

ShippingDimension

Wymiar wysyłki 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 produktu.

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: * month * year
period_length

int64

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

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.

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, podany jako kod CLDR.
region

string

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

bool

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

int64

Numeryczny identyfikator lokalizacji, do której ma zastosowanie stawka podatku, zdefiniowany w interfejsie AdWords API.
postal_code

string

Zakres kodów pocztowych, do których ma zastosowanie stawka podatku, reprezentowany przez kod pocztowy, prefiks kodu pocztowego z symbolem zastępczym *, zakres między 2 kodami pocztowymi lub 2 prefiksami kodu pocztowego o takiej samej długości. Przykłady: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingBaseMeasure

Podstawowa miara ceny jednostkowej produktu.

Pola
value

int64

Mianownik ceny jednostkowej.
unit

string

Jednostka mianownika.

UnitPricingMeasure

Jednostka miary ceny produktu.

Pola
value

double

Wymiar produktu.
unit

string

Jednostka miary.