- Zapis JSON
- Rata
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- Dostawa
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- Podatek
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- Certyfikat
- ProductStructuredTitle
- ProductStructuredDescription
Atrybuty.
Zapis JSON |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "gtin": [ string ], "price": { object ( |
Pola | |
---|---|
additional |
dodatkowe adresy URL zdjęć produktu, |
expiration |
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 |
disclosure |
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 na stronie [Disclosure date]( https://support.google.com/merchants/answer/13034208). |
availability |
Dzień, kiedy będzie możliwa dostawa produktu zamówionego w przedsprzedaży, w formacie ISO 8601. |
gtin[] |
Globalne numery jednostek handlowych (GTIN) produktu. Możesz podać maksymalnie 10 numerów GTIN. |
price |
Cena produktu. |
installment |
Liczba i wysokość rat do zapłaty za produkt. |
subscription |
Liczba okresów (miesięcy lub lat) i kwota płatności za okres abonamentu. |
loyalty |
Punkty lojalnościowe, które użytkownicy otrzymują po zakupie produktu. Tylko Japonia. |
loyalty |
Lista informacji o programie lojalnościowym, która jest używana do wyświetlania korzyści z programu lojalnościowego (np. lepszych cen, punktów itp.) użytkownikowi tego produktu. |
product |
Kategorie produktu (sformatowane zgodnie ze specyfikacją danych produktów). |
sale |
Reklamowana obniżona cena produktu. |
sale |
Zakres dat, w którym produkt jest oferowany po obniżonej cenie (patrz specyfikacja danych produktów). |
product |
Wysokość produktu w podanych jednostkach. Wartość musi mieścić się w zakresie od 0 (wykluczając tę wartość) do 3000 (włącznie). |
product |
Długość produktu w podanych jednostkach. Wartość musi mieścić się w zakresie od 0 (wykluczając tę wartość) do 3000 (włącznie). |
product |
Szerokość produktu w podanych jednostkach. Wartość musi mieścić się w zakresie od 0 (wykluczając tę wartość) do 3000 (włącznie). |
product |
waga produktu w podanych jednostkach. Wartość musi zawierać się w zakresie od 0 (wykluczając tę wartość) do 2000 (włącznie). |
shipping[] |
Reguły dostawy. |
free |
Warunki, które należy spełnić, aby produkt kwalifikował się do bezpłatnej dostawy. |
shipping |
Waga produktu na potrzeby dostawy. |
shipping |
Długość produktu do wysyłki. |
shipping |
Szerokość produktu na potrzeby dostawy. |
shipping |
Wysokość produktu na potrzeby dostawy. |
size |
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[] |
dane podatnika, |
unit |
Miara i wielkość produktu. |
unit |
Preferowany mianownik ceny jednostkowej. |
ads |
Podobna do adsGrouping, ale działa tylko w przypadku CPC. |
cost |
Koszt własny sprzedaży. Służy do raportowania zysku brutto. |
product |
Dane techniczne lub dodatkowe informacje o produkcie. |
product |
punkty opisujące najważniejsze informacje o produkcie, |
display |
Rekomendacje określone przez reklamodawcę. |
promotion |
Unikalny identyfikator promocji. |
included |
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 |
excluded |
Lista miejsc docelowych do wykluczenia w przypadku tej wartości docelowej (odpowiada odznaczonym polom wyboru w Merchant Center). |
shopping |
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. |
lifestyle |
Dodatkowe adresy URL zdjęć produktu w kontekście, które służą do wyraźnego identyfikowania zdjęć przedstawiających produkt w rzeczywistym kontekście. Więcej informacji znajdziesz w artykule w Centrum pomocy. |
cloud |
Dodatkowe pola do wyeksportowania do programu Cloud Retail. |
certifications[] |
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 |
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. |
identifier |
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 podana, przyjmuje domyślnie wartość „true”. |
is |
Określa, czy produkt jest pakietem utworzonym przez sprzedawcę. Pakiet to niestandardowa grupa różnych produktów sprzedawanych przez sprzedawcę za jedną cenę. |
title |
Tytuł produktu. |
description |
Opis produktu. |
link |
Adres URL prowadzący bezpośrednio do strony produktu w Twoim sklepie internetowym. |
mobile |
Adres URL strony docelowej Twojego produktu zoptymalizowanej pod kątem urządzeń mobilnych. |
canonical |
Adres URL kanonicznej wersji strony docelowej produktu. |
image |
Adres URL zdjęcia produktu. |
adult |
Ustaw jako prawda, jeśli produkt jest kierowany do dorosłych. |
age |
Docelowa grupa wiekowa, dla której jest przeznaczony produkt. |
availability |
Stan dostępności produktu. |
brand |
Marka produktu. |
color |
Kolor produktu. |
condition |
Stan produktu. |
gender |
Docelowa płeć klientów, dla których jest przeznaczony produkt. |
google |
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 |
Wspólny identyfikator wszystkich wersji tego samego produktu. |
material |
Materiał, z którego wykonano produkt. |
mpn |
Numer katalogowy (MPN) produktu. |
pattern |
Wzór produktu (np. kropki). |
sell |
Ilość produktu, która jest dostępna do sprzedaży w Google. Obsługiwane tylko w przypadku produktów dostępnych online. |
max |
Maksymalny czas obsługi zamówienia (w dniach roboczych). |
min |
Minimalny czas obsługi zamówienia (w dniach roboczych). |
shipping |
Etykieta wysyłki produktu, która służy do grupowania produktów w regułach dostawy na poziomie konta. |
transit |
Etykieta czasu przewozu produktu, która służy do grupowania produktów w tabelach czasu przewozu na poziomie konta. |
size |
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ą |
size |
System, w którym podano rozmiar. Zalecany w przypadku produktów odzieżowych. |
tax |
Kategoria podatkowa produktu, która służy do konfigurowania szczegółowych informacji o miejscu zamieszkania podatnika w ustawieniach podatkowych na poziomie konta. |
energy |
Klasa efektywności energetycznej określona w dyrektywie UE 2010/30/UE. |
min |
Klasa efektywności energetycznej określona w dyrektywie UE 2010/30/UE. |
max |
Klasa efektywności energetycznej określona w dyrektywie UE 2010/30/UE. |
multipack |
Liczba identycznych produktów w opakowaniu zbiorczym przygotowanym przez sprzedawcę. |
ads |
Służy do grupowania produktów w dowolny sposób. Tylko w przypadku CPA%, nie zalecane w innych przypadkach. |
ads |
Umożliwia reklamodawcom zastąpienie adresu URL produktu, gdy produkt jest wyświetlany w kontekście reklamy produktowej. |
display |
Identyfikator produktu w kampaniach remarketingu dynamicznego. |
display |
Tytuł produktu w kampaniach remarketingu dynamicznego. |
display |
URL kierujący bezpośrednio do strony docelowej produktu reklamowanego w ramach kampanii remarketingu dynamicznego. |
display |
Marża ofertowa dla kampanii remarketingu dynamicznego. |
pickup |
Opcja odbioru produktu. |
pickup |
Czas, w którym produkt jest dostępny do odbioru w sklepie |
link |
Szablon linku do lokalnej witryny sklepowej sprzedawcy. |
mobile |
Szablon linku do lokalnej witryny sklepowej sprzedawcy zoptymalizowanej pod kątem urządzeń mobilnych. |
custom |
Etykieta własna 0 służąca do niestandardowego grupowania produktów w kampanii produktowej. |
custom |
Etykieta własna 1 służąca do niestandardowego grupowania produktów w kampanii produktowej. |
custom |
Etykieta własna 2 służąca do niestandardowego grupowania produktów w kampanii produktowej. |
custom |
Etykieta własna 3 służąca do niestandardowego grupowania produktów w kampanii produktowej. |
custom |
Etykieta własna 4 służąca do niestandardowego grupowania produktów w kampanii produktowej. |
external |
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 |
Publikacja tego elementu zostanie tymczasowo wstrzymana. |
virtual |
Adres URL obrazu 3D produktu. Więcej informacji znajdziesz w artykule w Centrum pomocy. |
structured |
tytuł strukturalny – w przypadku tytułów wygenerowanych algorytmicznie (AI); |
structured |
Opis strukturalny – w przypadku opisów wygenerowanych algorytmicznie (AI). |
Instalacja
Wiadomość reprezentująca ratę.
Zapis JSON |
---|
{ "months": string, "amount": { object ( |
Pola | |
---|---|
months |
Liczba rat, które kupujący musi zapłacić. |
amount |
Miesięczna kwota do zapłacenia przez kupującego. |
downpayment |
Kwota wpłaty z góry, którą kupujący musi zapłacić. |
credit |
Typ rat. Obsługiwane wartości: * |
SubscriptionCost
Koszt subskrypcji produktu.
Zapis JSON |
---|
{ "period": enum ( |
Pola | |
---|---|
period |
Typ okresu subskrypcji. Obsługiwane wartości: * |
period |
Liczba okresów abonamentowych, które kupujący jest zobowiązany opłacić. |
amount |
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. |
LoyaltyPoints
Komunikat reprezentujący punkty lojalnościowe.
Zapis JSON |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
Pola | |
---|---|
name |
Nazwa programu lojalnościowego. Zalecamy ograniczenie nazwy do 12 znaków o pełnej szerokości lub 24 znaków alfabetu łacińskiego. |
points |
Punkty lojalnościowe sprzedawcy w wartości bezwzględnej. |
ratio |
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.
Zapis JSON |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
Pola | |
---|---|
program |
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 |
Etykieta poziomu w programie lojalnościowym. Musi być zgodna z jedną z etykietek w programie. |
price |
Cena dla członków danego poziomu, czyli cena z natychmiastowym rabatem. Musi być mniejsza lub równa regularnej cenie. |
cashback |
Środki, które można wykorzystać na przyszłe zakupy. |
loyalty |
Liczba punktów lojalnościowych zdobytych za zakup. |
member |
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 |
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 zostanie podana, produkt nie kwalifikuje się do dostawy w ramach programu lojalnościowego na danym poziomie. |
ProductDimension
Wymiar produktu.
Zapis JSON |
---|
{ "value": number, "unit": string } |
Pola | |
---|---|
value |
Wymagane. Wartość wymiaru podana jako liczba. Wartość może mieć maksymalnie 4 miejsca po przecinku. |
unit |
Wymagane. Jednostki wymiarów. Akceptowane wartości to: * „ |
ProductWeight
Waga produktu.
Zapis JSON |
---|
{ "value": number, "unit": string } |
Pola | |
---|---|
value |
Wymagane. Waga podana jako liczba. Waga może mieć maksymalnie 4 miejsca po przecinku. |
unit |
Wymagane. Jednostka wagi. Akceptowane wartości: * „ |
Dostawa
Dostawa produktu.
Zapis JSON |
---|
{
"price": {
object ( |
Pola | |
---|---|
price |
Stałe koszty dostawy podane w postaci liczby. |
country |
Kod regionu CLDR kraju, do którego wysyłany jest produkt. |
region |
Region geograficzny, w którym obowiązuje stawka dostawy. Więcej informacji znajdziesz w regionie. |
service |
Wolny opis klasy usługi lub szybkości dostawy. |
location |
Numeryczny identyfikator lokalizacji, do której ma zastosowanie stawka dostawy, zdefiniowany w interfejsie AdWords API. |
location |
Lokalizacja, w której obowiązuje dostawa, reprezentowana przez nazwę grupy lokalizacji. |
postal |
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 |
Minimalny czas obsługi zamówienia (w tym samym dniu) w dniach roboczych od momentu jego przyjęcia do wysyłki. Wartość 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ść |
max |
Maksymalny czas obsługi zamówienia (w tym czasie) między jego otrzymaniem a wysłaniem w dniach roboczych. Wartość 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 |
min |
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ść |
max |
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 |
FreeShippingThreshold
Warunki, które należy spełnić, aby produkt kwalifikował się do bezpłatnej dostawy.
Zapis JSON |
---|
{
"country": string,
"priceThreshold": {
object ( |
Pola | |
---|---|
country |
Kod regionu CLDR kraju, do którego wysyłany jest produkt. |
price |
Minimalna cena produktu, aby koszt dostawy był bezpłatny. Jest reprezentowany jako liczba. |
ShippingWeight
Waga przesyłki produktu.
Zapis JSON |
---|
{ "value": number, "unit": string } |
Pola | |
---|---|
value |
Waga produktu, która służy do obliczenia kosztów jego dostawy |
unit |
Jednostka wartości. |
ShippingDimension
Wymiar wysyłki produktu.
Zapis JSON |
---|
{ "value": number, "unit": string } |
Pola | |
---|---|
value |
Wymiar produktu, który służy do obliczenia kosztów jego dostawy. |
unit |
Jednostka wartości. |
Podatek
Podatek od produktu.
Zapis JSON |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
Pola | |
---|---|
rate |
Procent stawki podatku, która obowiązuje w przypadku ceny produktu. |
country |
Kraj, w którym produkt jest opodatkowany, podany jako kod CLDR. |
region |
Region geograficzny, w którym obowiązuje stawka podatku. |
tax |
Ustaw jako Prawda, jeśli podatek jest naliczany od dostawy. |
location |
Numeryczny identyfikator lokalizacji, do której ma zastosowanie stawka podatku, zdefiniowany w interfejsie AdWords API. |
postal |
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*. |
UnitPricingMeasure
Jednostka miary ceny produktu.
Zapis JSON |
---|
{ "value": number, "unit": string } |
Pola | |
---|---|
value |
Wymiar produktu. |
unit |
Jednostka miary. |
UnitPricingBaseMeasure
Podstawowa miara ceny jednostkowej produktu.
Zapis JSON |
---|
{ "value": string, "unit": string } |
Pola | |
---|---|
value |
Mianownik ceny jednostkowej. |
unit |
Jednostka mianownika. |
ProductDetail
Szczegóły produktu.
Zapis JSON |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
Pola | |
---|---|
section |
Nagłówek sekcji służący do grupowania zestawu informacji o produkcie. |
attribute |
Nazwa szczegółów produktu. |
attribute |
Wartość szczegółów produktu. |
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”.
Zapis JSON |
---|
{ "textValue": [ string ], "intValue": [ string ], "floatValue": [ number ], "propertyName": string, "boolValue": boolean, "minValue": number, "maxValue": number, "unitCode": string } |
Pola | |
---|---|
text |
Wartość tekstowa danej właściwości. Na przykład „8K(UHD)” może być wartością tekstową w przypadku 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 |
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 |
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 |
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 |
Wartość logiczna danej właściwości. Na przykład w przypadku telewizora wartość „True” lub „False” oznacza, czy ekran jest UHD. |
min |
Minimalna wartość zmiennoprzecinkowa danej właściwości. Na przykład w przypadku telewizora 1.00. |
max |
Maksymalna wartość zmiennoprzecinkowa danej właściwości. Na przykład w przypadku telewizora 100.00. |
unit |
Jednostka danej właściwości. Na przykład „Pixele” w przypadku telewizora. Maksymalny rozmiar ciągu to 256 B. |
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.
Zapis JSON |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
Pola | |
---|---|
certification |
Urząd certyfikacji, np. „European_Commission”. Maksymalna długość to 2000 znaków. |
certification |
Nazwa certyfikatu, np. „EPREL”. Maksymalna długość to 2000 znaków. |
certification |
Kod certyfikatu. Maksymalna długość to 2000 znaków. |
certification |
Wartość certyfikatu (zwana też klasą, poziomem lub oceną), np. „A+”, „C”, „złoty”. Maksymalna długość to 2000 znaków. |
ProductStructuredTitle
Tytuł strukturalny – w przypadku tytułów wygenerowanych algorytmicznie (AI).
Zapis JSON |
---|
{ "digitalSourceType": string, "content": string } |
Pola | |
---|---|
digital |
Typ źródła cyfrowego, np. „trained_algorithmic_media”. zgodnie z IPTC. Maksymalna długość to 40 znaków. |
content |
Maksymalna długość tekstu tytułu to 150 znaków. |
ProductStructuredDescription
Opis strukturalny – w przypadku opisów wygenerowanych algorytmicznie (AI).
Zapis JSON |
---|
{ "digitalSourceType": string, "content": string } |
Pola | |
---|---|
digital |
Typ źródła cyfrowego, np. „trained_algorithmic_media”. zgodnie z IPTC. Maksymalna długość to 40 znaków. |
content |
Maksymalna długość tekstu opisu to 5000 znaków |