Indeks
ProductInputsService
(interfejs)ProductsService
(interfejs)Attributes
(komunikat)Certification
(komunikat)CloudExportAdditionalProperties
(komunikat)DeleteProductInputRequest
(komunikat)FreeShippingThreshold
(komunikat)GetProductRequest
(komunikat)InsertProductInputRequest
(komunikat)Installment
(komunikat)ListProductsRequest
(komunikat)ListProductsResponse
(komunikat)LoyaltyPoints
(komunikat)LoyaltyProgram
(komunikat)Product
(komunikat)ProductDetail
(komunikat)ProductDimension
(komunikat)ProductInput
(komunikat)ProductStatus
(komunikat)ProductStatus.DestinationStatus
(komunikat)ProductStatus.ItemLevelIssue
(komunikat)ProductStatus.ItemLevelIssue.Severity
(wyliczenie)ProductStructuredDescription
(komunikat)ProductStructuredTitle
(komunikat)ProductWeight
(komunikat)Shipping
(komunikat)ShippingDimension
(komunikat)ShippingWeight
(komunikat)SubscriptionCost
(komunikat)SubscriptionPeriod
(wyliczenie)Tax
(komunikat)UnitPricingBaseMeasure
(komunikat)UnitPricingMeasure
(komunikat)
ProductInputsService
Usługa wykorzystująca zasób ProductInput. Ta usługa dotyczy tylko produktów z kanałem online.
DeleteProductInput |
---|
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.
|
InsertProductInput |
---|
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.
|
ProductsService
Usługa do korzystania z zasobu produktu. Ta usługa dotyczy tylko produktów z kanałem online.
GetProduct |
---|
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.
|
ListProducts |
---|
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.
|
Atrybuty
Atrybuty.
Pola | |
---|---|
additional_image_links[] |
Dodatkowe adresy URL zdjęć produktu. |
expiration_date |
Data ważności produktu podana w formacie ISO 8601 podana przy wstawieniu. Rzeczywista data ważności jest wyświetlana w |
disclosure_date |
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 |
Dzień, kiedy będzie możliwa dostawa produktu zamówionego w przedsprzedaży, podany w formacie ISO 8601. |
price |
Cena produktu. |
installment |
Liczba i kwota rat do zapłacenia za produkt. |
subscription_cost |
Liczba okresów (miesięcy lub lat) i kwota płatności w danym okresie za produkt z powiązaną umową subskrypcyjną. |
loyalty_points |
Punkty lojalnościowe przyznawane użytkownikom po zakupie produktu. Tylko Japonia. |
loyalty_programs[] |
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[] |
Kategorie produktu (w formacie zgodnym ze specyfikacją danych produktów). |
sale_price |
Reklamowana cena promocyjna produktu. |
sale_price_effective_date |
Zakres dat, w którym produkt jest oferowany po obniżonej cenie (zobacz specyfikację danych produktów). |
product_height |
Wysokość produktu w podanych jednostkach. Wartość musi znajdować się w zakresie od 0 (bez uwzględnienia) do 3000 (włącznie). |
product_length |
Długość produktu w podanych jednostkach. Wartość musi znajdować się w zakresie od 0 (bez uwzględnienia) do 3000 (włącznie). |
product_width |
Szerokość produktu w podanych jednostkach. Wartość musi znajdować się w zakresie od 0 (bez uwzględnienia) do 3000 (włącznie). |
product_weight |
Waga produktu w podanych jednostkach. Wartość musi znajdować się w zakresie od 0 (bez uwzględnienia) do 2000 (włącznie). |
shipping[] |
Zasady dostawy. |
free_shipping_threshold[] |
Warunki, które muszą zostać spełnione, aby produkt miał bezpłatną dostawę. |
shipping_weight |
Waga wysyłanego produktu. |
shipping_length |
Długość produktu przeznaczonego do wysyłki. |
shipping_width |
Szerokość produktu przeznaczonego do wysyłki. |
shipping_height |
Wysokość wysyłanego produktu. |
size_types[] |
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[] |
Dane podatnika. |
unit_pricing_measure |
Miara i wymiar produktu. |
unit_pricing_base_measure |
Preferowany mianownik ceny jednostkowej. |
ads_labels[] |
Podobny do parametru ads_grouping, ale działa tylko w przypadku określania stawek CPC. |
cost_of_goods_sold |
Koszt własny sprzedaży. Służy do raportowania zysków brutto. |
product_details[] |
Specyfikacja techniczna lub dodatkowe szczegóły produktu. |
product_highlights[] |
Listy punktowane opisujące najważniejsze cechy produktu. |
display_ads_similar_ids[] |
Rekomendacje określone przez reklamodawcę. |
promotion_ids[] |
Unikalny identyfikator promocji. |
included_destinations[] |
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 |
excluded_destinations[] |
Lista miejsc docelowych do wykluczenia w przypadku tego celu (odpowiada niezaznaczonym polom wyboru w Merchant Center). |
shopping_ads_excluded_countries[] |
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. |
lifestyle_image_links[] |
Dodatkowe adresy URL zdjęć przedstawiających produkt w kontekście, które służą do jednoznacznej identyfikacji zdjęć, które przedstawiają produkt w rzeczywistym kontekście. Więcej informacji znajdziesz w tym artykule w Centrum pomocy. |
cloud_export_additional_properties[] |
Dodatkowe pola do wyeksportowania do programu Cloud Retail. |
certifications[] |
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 |
Zabezpieczenie w „Rabatach automatycznych” (https://support.google.com/merchants/answer/10295759) i „Promocje dynamiczne” (https://support.google.com/merchants/answer/13949249) projektów, co zapewnia rabaty na oferty nie osiągają tej wartości, co z kolei zachowuje ich wartość i rentowność. |
identifier_exists |
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 |
Informacja, czy produkt jest pakietem przygotowanym przez sprzedawcę. Pakiet to niestandardowa grupa różnych produktów sprzedawanych przez sprzedawcę w jednej cenie. |
title |
Tytuł produktu. |
description |
Opis produktu. |
link |
Adres URL prowadzący bezpośrednio do strony produktu w Twoim sklepie internetowym. |
mobile_link |
Adres URL strony docelowej Twojego produktu zoptymalizowanej pod kątem urządzeń mobilnych. |
canonical_link |
URL kanonicznej wersji strony docelowej produktu. |
image_link |
Adres URL zdjęcia produktu. |
adult |
Jeśli produkt jest kierowany do dorosłych, ustaw wartość „true” (prawda). |
age_group |
Docelowa grupa wiekowa elementu. |
availability |
Stan dostępności produktu. |
brand |
Marka produktu. |
color |
Kolor produktu. |
condition |
Stan lub stan produktu. |
gender |
Docelowa płeć produktu. |
google_product_category |
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 |
Globalny numer jednostki handlowej (GTIN) produktu. |
item_group_id |
Wspólny identyfikator wszystkich wersji tego samego produktu. |
material |
Materiał, z którego wykonano produkt. |
mpn |
Numer katalogowy produktu (MPN). |
pattern |
Wzór produktu (np. grochy). |
sell_on_google_quantity |
Liczba produktów dostępnych do sprzedaży w Google. Obsługiwane tylko w przypadku produktów online. |
max_handling_time |
Maksymalny czas obsługi produktu (w dniach roboczych). |
min_handling_time |
Minimalny czas obsługi zamówienia (w dniach roboczych). |
shipping_label |
Etykieta wysyłki produktu służąca do grupowania produktu w regułach dostawy na poziomie konta. |
transit_time_label |
Etykieta czasu przewozu produktu używana do grupowania produktów w tabelach czasu przewozu na poziomie konta. |
size |
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ą |
size_system |
System, w którym określa się rozmiar. Zalecany w przypadku produktów odzieżowych. |
tax_category |
Kategoria podatkowa produktu używana do konfigurowania szczegółowego zakładu podatkowego w ustawieniach podatków na poziomie konta. |
energy_efficiency_class |
Klasa efektywności energetycznej zdefiniowana w dyrektywie UE 2010/30/UE. |
min_energy_efficiency_class |
Klasa efektywności energetycznej zdefiniowana w dyrektywie UE 2010/30/UE. |
max_energy_efficiency_class |
Klasa efektywności energetycznej zdefiniowana w dyrektywie UE 2010/30/UE. |
multipack |
Liczba identycznych produktów w opakowaniu zbiorczym przygotowanym przez sprzedawcę. |
ads_grouping |
Służy do grupowania elementów w dowolny sposób. Tylko w przypadku CPA%; niezalecane. |
ads_redirect |
Pozwala reklamodawcom zastąpić adres URL produktu, gdy produkt jest wyświetlany w kontekście reklam produktów. |
display_ads_id |
Identyfikator produktu w kampaniach remarketingu dynamicznego. |
display_ads_title |
Tytuł produktu w kampaniach remarketingu dynamicznego. |
display_ads_link |
URL bezpośrednio do strony docelowej produktu dla kampanii remarketingu dynamicznego. |
display_ads_value |
Marża ofertowa dla kampanii remarketingu dynamicznego. |
pickup_method |
Opcja odbioru produktu. |
pickup_sla |
Oś czasu odbioru produktu w sklepie. |
link_template |
Szablon linku do lokalnej witryny sklepowej sprzedawcy. |
mobile_link_template |
Szablon linku do lokalnej witryny sklepowej sprzedawcy zoptymalizowanego pod kątem urządzeń mobilnych. |
custom_label_0 |
Etykieta własna 0 – niestandardowe grupowanie elementów w kampanii produktowej. |
custom_label_1 |
Etykieta własna 1 dla niestandardowego grupowania produktów w kampanii produktowej. |
custom_label_2 |
Etykieta własna 2 – niestandardowe grupowanie produktów w kampanii produktowej. |
custom_label_3 |
Etykieta własna 3 – niestandardowe grupowanie produktów w kampanii produktowej. |
custom_label_4 |
Etykieta własna 4 – niestandardowe grupowanie elementów w kampanii produktowej. |
external_seller_id |
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 |
Publikowanie tego elementu zostanie tymczasowo wstrzymane. |
virtual_model_link |
Adres URL zdjęcia 3D produktu. Więcej informacji znajdziesz w tym artykule w Centrum pomocy. |
structured_title |
Tytuł uporządkowany w przypadku tytułów generowanych przez algorytm (AI). |
structured_description |
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 |
Urząd certyfikacji, na przykład „European_Commission”. Maksymalna długość to 2000 znaków. |
certification_name |
Nazwa certyfikatu, na przykład „EPREL”. Maksymalna długość to 2000 znaków. |
certification_code |
Kod certyfikatu. Maksymalna długość to 2000 znaków. |
certification_value |
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ład: właściwości produktu telewizyjnego to „Rozdzielczość ekranu” lub „Rozmiar ekranu”.
Pola | |
---|---|
text_value[] |
Wartość tekstowa danej właściwości. Na przykład „8K(UHD)” może być wartością tekstową dla produktu telewizyjnego. 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[] |
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[] |
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 |
Nazwa danej usługi. Na przykład „Rozdzielczość ekranu” dla telewizorów. Maksymalny rozmiar ciągu to 256 znaków. |
bool_value |
Wartość logiczna danej właściwości. Na przykład w przypadku produktu telewizyjnego: „Prawda”. lub „False” jeśli ekran jest w jakości UHD. |
min_value |
Minimalna wartość zmiennoprzecinkowa danej właściwości. Na przykład telewizor 1.00. |
max_value |
Maksymalna wartość zmiennoprzecinkowa danej właściwości. Na przykład w przypadku telewizora o wartości 100,00. |
unit_code |
Jednostka danej właściwości. Na przykład „Piksele” dla telewizorów. Maksymalny rozmiar ciągu znaków to 256 B. |
DeleteProductInputRequest
Komunikat żądania dotyczący metody DeleteProductInput.
Pola | |
---|---|
name |
Wymagane. Nazwa zasobu wejściowego produktu do usunięcia. Format: accounts/{konto}/productInputs/{product} |
data_source |
Wymagane. Podstawowe lub dodatkowe źródło danych, z którego należy usunąć dane wejściowe o produktach. Format: |
FreeShippingThreshold
Warunki, które muszą zostać spełnione, aby produkt miał bezpłatną dostawę.
Pola | |
---|---|
country |
Kod regionu CLDR odpowiadający krajowi, do którego zostanie wysłany produkt. |
price_threshold |
Minimalna cena produktu, od której chcesz płacić za dostawę. Liczebność. |
GetProductRequest
Komunikat żądania dla metody GetProduct.
Pola | |
---|---|
name |
Wymagane. Nazwa produktu do pobrania. Format: |
InsertProductInputRequest
Komunikat żądania dla metody InsertProductInput.
Pola | |
---|---|
parent |
Wymagane. Konto, na którym chcesz wstawić ten produkt. Format: konta/{konto} |
product_input |
Wymagane. Dane wejściowe produktu do wstawienia. |
data_source |
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: |
Instalacja
Komunikat reprezentujący ratę.
Pola | |
---|---|
months |
Liczba rat, które kupujący musi zapłacić. |
amount |
Miesięczna kwota, którą kupujący musi zapłacić. |
downpayment |
Kwota pierwszej wpłaty, którą musi zapłacić kupujący. |
credit_type |
Typ płatności ratalnej. Obsługiwane wartości to: * „ |
ListProductsRequest
Komunikat żądania metody ListProducts.
Pola | |
---|---|
parent |
Wymagane. Konto, dla którego ma się wyświetlać lista produktów przetworzonych. Format: konta/{konto} |
page_size |
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 |
Token strony otrzymany z poprzedniego wywołania funkcji Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu |
ListProductsResponse
Komunikat odpowiedzi dla metody ListProducts.
Pola | |
---|---|
products[] |
Przetworzone produkty z określonego konta. Są to produkty przetworzone po zastosowaniu reguł i dodatkowych źródeł danych. |
next_page_token |
Token, który może zostać wysłany jako |
LoyaltyPoints
Komunikat reprezentujący punkty lojalnościowe.
Pola | |
---|---|
name |
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 |
Wartość bezwzględna liczby punktów lojalnościowych przyznawanych przez sprzedawcę. |
ratio |
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 |
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 |
Etykieta poziomu w programie lojalnościowym. Musi pasować do jednej z etykiet w programie. |
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 |
Zwrot za zakupy, który można wykorzystać na przyszłe zakupy. |
loyalty_points |
Liczba punktów lojalnościowych zdobytych za zakup. |
member_price_effective_date |
Zakres dat, w którym produkt kwalifikuje się do skorzystania z ceny dla uczestników programu. Jeśli jej nie podasz, obowiązuje zawsze cena dla uczestników programu. Zakres dat jest reprezentowany przez parę dat w formacie ISO 8601 rozdzielonych spacją, przecinkiem lub ukośnikiem. |
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 |
Nazwa produktu. Format: |
channel |
Tylko dane wyjściowe. Kanał produktu. |
offer_id |
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 |
Tylko dane wyjściowe. Dwuliterowy kod języka ISO 639-1. |
feed_label |
Tylko dane wyjściowe. Etykieta pliku danych produktu. |
data_source |
Tylko dane wyjściowe. Podstawowe źródło danych produktu. |
attributes |
Tylko dane wyjściowe. Lista atrybutów produktów. |
custom_attributes[] |
Tylko dane wyjściowe. Lista niestandardowych atrybutów (dostarczonych przez sprzedawcę). Możesz go też użyć, aby przesłać dowolny atrybut specyfikacji danych w ogólnej formie (np. |
product_status |
Tylko dane wyjściowe. Stan produktu, problemy z weryfikacją danych, czyli informacje o produkcie obliczone asynchronicznie. |
version_number |
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 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 |
Nagłówek sekcji służący do grupowania zestawu szczegółów produktu. |
attribute_name |
Nazwa szczegółów produktu. |
attribute_value |
Wartość szczegółów produktu. |
ProductDimension
Wymiar produktu.
Pola | |
---|---|
value |
Wymagane. Wartość wymiaru przedstawiona w postaci liczby. Wartość może mieć maksymalnie cztery miejsca po przecinku. |
unit |
Wymagane. Jednostki wymiarów. Akceptowane wartości: * „ |
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 |
Identyfikator. Nazwa danych wejściowych o produkcie. Format: |
product |
Tylko dane wyjściowe. Nazwa przetworzonego produktu. Format: |
channel |
Wymagane. Stały. Kanał produktu. |
offer_id |
Wymagane. Stały. 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 |
Wymagane. Stały. Dwuliterowy kod języka ISO 639-1. |
feed_label |
Wymagane. Stały. Etykieta pliku danych produktu. |
attributes |
Opcjonalnie: Lista atrybutów produktów. |
custom_attributes[] |
Opcjonalnie: Lista niestandardowych atrybutów (dostarczonych przez sprzedawcę). Możesz go też wykorzystać, aby przesłać dowolny atrybut specyfikacji danych w ogólnej formie (np. |
version_number |
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 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[] |
Zamierzone miejsca docelowe produktu. |
item_level_issues[] |
Lista wszystkich problemów z usługą. |
creation_date |
Data utworzenia elementu podana w formacie ISO 8601. |
last_update_date |
Data ostatniej aktualizacji produktu podana w formacie ISO 8601. |
google_expiration_date |
Data wygaśnięcia produktu podana w formacie ISO 8601. |
DestinationStatus
Stan miejsca docelowego stanu produktu.
Pola | |
---|---|
reporting_context |
Nazwa kontekstu raportowania. |
approved_countries[] |
Lista kodów krajów (ISO 3166-1 alfa-2), w których oferta jest zatwierdzona. |
pending_countries[] |
Lista kodów krajów (ISO 3166-1 alfa-2), w których oferta oczekuje na zatwierdzenie. |
disapproved_countries[] |
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 |
Kod błędu, którego dotyczy problem. |
severity |
Jak ten problem wpływa na wyświetlanie oferty. |
resolution |
czy problem może zostać rozwiązany przez sprzedawcę. |
attribute |
Nazwa atrybutu, jeśli problem jest spowodowany przez jeden atrybut. |
reporting_context |
Kontekst raportowania, którego dotyczy problem. |
description |
Krótki opis problemu w języku angielskim. |
detail |
Szczegółowy opis problemu w języku angielskim. |
documentation |
Adres URL strony internetowej, która ma pomóc w rozwiązaniu tego problemu. |
applicable_countries[] |
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 |
Typ źródła cyfrowego, np. „training_algorithmic_media”. Obserwujesz IPTC. Maksymalna długość to 40 znaków. |
content |
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 |
Typ źródła cyfrowego, np. „training_algorithmic_media”. Obserwujesz IPTC. Maksymalna długość to 40 znaków. |
content |
Tekst tytułu Maksymalna długość to 150 znaków |
ProductWeight
Waga produktu.
Pola | |
---|---|
value |
Wymagane. Waga przedstawiana jako liczba. Waga może mieć maksymalnie cztery miejsca po przecinku. |
unit |
Wymagane. Jednostka wagi. Akceptowane wartości: * „ |
Dostawa
Dostawa produktu.
Pola | |
---|---|
price |
Stała cena dostawy w postaci liczby. |
country |
Kod regionu CLDR odpowiadający krajowi, do którego zostanie wysłany produkt. |
region |
Region geograficzny, do którego odnosi się koszt dostawy. Aby dowiedzieć się więcej, sprawdź region. |
service |
Swobodny opis klasy usługi lub szybkości dostarczania. |
location_id |
Identyfikator numeryczny lokalizacji, do której odnosi się koszt dostawy, jak określono w interfejsie API AdWords. |
location_group_name |
Lokalizacja, w której możliwa jest dostawa, reprezentowana przez nazwę grupy lokalizacji. |
postal_code |
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 |
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_handlingTime] będzie można podać tylko razem z [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]; ale nie jest wymagany, jeśli podano [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]. |
max_handling_time |
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 podano parametr [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]. |
min_transit_time |
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 być występująca tylko razem z wartością [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]; ale nie jest wymagany, jeśli podano [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. |
max_transit_time |
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 podany jest atrybut [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. |
ShippingDimension
ShippingDimensions produktu.
Pola | |
---|---|
value |
Wymiar produktu, który służy do obliczenia kosztów jego dostawy. |
unit |
Jednostka wartości. |
ShippingWeight
Waga przesyłki z produktem.
Pola | |
---|---|
value |
Waga produktu, która służy do obliczenia kosztów jego dostawy. |
unit |
Jednostka wartości. |
SubscriptionCost
Koszt abonamentu produktu.
Pola | |
---|---|
period |
Typ okresu subskrypcji. Obsługiwane wartości to: * „ |
period_length |
Liczba okresów subskrypcji, które kupujący musi zapłacić. |
amount |
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 |
Procent stawki podatku, która ma zastosowanie do ceny produktu. |
country |
Kraj, w którym produkt jest opodatkowany, określony za pomocą kodu regionu CLDR. |
region |
Region geograficzny, w którym obowiązuje stawka podatku. |
tax_ship |
Ustaw wartość Prawda, jeśli podatek jest naliczany od dostawy. |
location_id |
Identyfikator numeryczny lokalizacji, do której odnosi się stawka podatku, jak określono w interfejsie API AdWords. |
postal_code |
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 |
Mianownik ceny jednostkowej. |
unit |
Jednostka mianownika. |
UnitPricingMeasure
Wartość UnitPricingMeasure produktu.
Pola | |
---|---|
value |
Miara produktu. |
unit |
Jednostka miary. |