- Zapis JSON
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- Data
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- Zarabianie
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
- EventMetadata
- Powierzchnia
Adres URL działania z powiązanym językiem, listą krajów, w których jest ono ograniczone, i opcjonalną platformą, która wskazuje, na której platformie to działanie powinno być wykonywane.
| Zapis JSON |
|---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
| Pola | |
|---|---|
url |
Adres URL punktu wejścia dla tego linku do działania. |
language |
Tag języka BCP-47 określający język, w którym dostępne są treści z tego URI. |
restrictedCountry[] |
Kod kraju zgodny ze standardem ISO 3166-1 alpha-2. Aby zezwolić na nieograniczoną widoczność, zostaw to pole puste. |
platform |
Platforma, na której ma zostać wykonane to działanie. Jeśli to pole nie jest ustawione, jako wartość zastępcza zostanie użyta wartość ACTION_PLATFORM_WEB_APPLICATION. |
actionLinkType |
Wstępnie określony typ działania. |
orderOnlineMetadata |
Metadane linku do składania zamówień online. Obsługuje działanie z wartością ActionLinkType równą ACTION_LINK_TYPE_SHOP_ONLINE. |
foodOrderingMetadata |
Metadane linków do zamawiania jedzenia. Obsługuje typ działania: * |
eventMetadata |
Dodatkowe informacje o linku do działania, które są unikalne dla kategorii wydarzeń. |
ActionPlatform
Platforma, na której wykonano czynność. Aplikacja internetowa jest ogólną opcją zastępczą. Zalecamy, aby mieć co najmniej 1 element ActionLink z wartością ACTION_PLATFORM_WEB_APPLICATION. Linki z platformami Android i iOS są używane tylko w odpowiednich systemach.
| Wartości w polu enum | |
|---|---|
ACTION_PLATFORM_UNSPECIFIED |
Platforma nie jest określona. |
ACTION_PLATFORM_WEB_APPLICATION |
Platformą działania jest ogólnie internet. |
ACTION_PLATFORM_MOBILE_WEB |
Platformą działania jest internet na urządzeniach mobilnych. |
ACTION_PLATFORM_ANDROID |
Platformą działania jest system operacyjny Android. |
ACTION_PLATFORM_IOS |
Platformą działania jest iOS. |
ActionLinkType
Z linkiem do działania jest powiązany określony typ działania.
| Wartości w polu enum | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
Typ linku do działania jest nieokreślony. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
Typem linku do działania jest rezerwacja spotkania. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
Typem linku do działania jest rezerwacja spotkania online. |
ACTION_LINK_TYPE_ORDER_FOOD |
Rodzaj linku do działania to zamawianie jedzenia z dostawą lub na wynos albo oba te rodzaje. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
Typem linku do działania jest zamawianie jedzenia z dostawą. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
Typ linku do działania to zamawianie jedzenia na wynos. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
Typ linku do działania to rezerwacja miejsca w restauracji. |
ACTION_LINK_TYPE_SHOP_ONLINE |
Typ linku do działania to zamawianie w przypadku zakupów. Może to być dostawa, odbiór lub obie te opcje. |
OrderOnlineMetadata
Metadane linku do działania „Zamów online”.
| Zapis JSON |
|---|
{
"fulfillmentOption": [
{
object ( |
| Pola | |
|---|---|
fulfillmentOption[] |
Dostępne opcje realizacji zamówienia w przypadku linku do działania „Zamów online”. |
FulfillmentOption
Opcja realizacji linku do działania „Zamów online”.
| Zapis JSON |
|---|
{ "fulfillmentType": enum ( |
| Pola | |
|---|---|
fulfillmentType |
Wymagane. Typ realizacji zamówień. |
availableDay[] |
Wymagane. Lista dni, w których ta metoda realizacji jest dostępna (najlepiej co najmniej 2). |
feeDetails |
Wymagane. Szczegóły opłat za metodę realizacji. |
minimumOrder |
Wymagane. Minimalne zamówienie w przypadku metody realizacji powiązanej z linkiem do działania. |
FulfillmentType
Typ realizacji powiązany z linkiem do działania.
| Wartości w polu enum | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Typ realizacji zamówień nie został określony. |
FULFILLMENT_TYPE_DELIVERY |
Typ realizacji zamówienia to dostawa. |
FULFILLMENT_TYPE_PICKUP |
Typ realizacji zamówień to odbiór. |
AvailableDay
Dostępność na poziomie dnia.
| Zapis JSON |
|---|
{
"fulfillmentDate": {
object ( |
| Pola | |
|---|---|
fulfillmentDate |
Wymagane. Dostępna data dla metody realizacji. Zakłada się, że jest to strefa czasowa sprzedawcy. |
lastOrderingTime |
Wymagane. Sygnatura czasowa w formacie czasu uniksowego. Ostatni dzień, w którym użytkownik mógł zamówić i otrzymać produkty, to Jeśli na przykład fulfillmentDate to 2020-08-10, wartość lastOrderingTime 2020-08-10 18:00 oznacza, że aby otrzymać zamówienie 10 sierpnia 2020 r., klient musi złożyć zamówienie do godziny 18:00 tego samego dnia. – wartość lastOrderingTime 2020-08-08 20:00 oznacza, że aby otrzymać zamówienie 10 sierpnia 2020 r., klient musi złożyć zamówienie do godziny 20:00 dwa dni wcześniej. Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: |
Data
Reprezentuje pełną lub częściową datę kalendarzową, np. datę urodzin. Pora dnia i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podana w kalendarzu gregoriańskim. Może to być jedna z tych wartości:
- Pełna data z wartościami roku, miesiąca i dnia różnymi od zera.
- Miesiąc i dzień z rokiem zerowym (np. rocznica).
- Sam rok, z miesiącem i dniem o wartości zero.
- Rok i miesiąc z dniem zerowym (np. data ważności karty kredytowej).
Powiązane typy:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| Zapis JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Pola | |
|---|---|
year |
Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, jeśli określasz datę bez roku. |
month |
Miesiąc roku. Musi mieścić się w zakresie od 1 do 12 lub wynosić 0, jeśli określasz rok bez miesiąca i dnia. |
day |
Dzień miesiąca. Wartość musi mieścić się w zakresie od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub wynosić 0, jeśli określasz sam rok albo rok i miesiąc, w których dzień nie ma znaczenia. |
FeeDetails
Szczegóły opłat za metodę realizacji powiązaną z linkiem do działania.
| Zapis JSON |
|---|
{ // Union field |
| Pola | |
|---|---|
Pole zbiorcze fee_details. Model opłat za metodę realizacji. fee_details może mieć tylko jedną z tych wartości: |
|
noFee |
Brak opłaty za metodę realizacji. |
baseFee |
Opłata podstawowa powiązana z metodą realizacji. |
fixedFee |
Opłata stała powiązana z metodą realizacji. |
NoFee
Ten typ nie ma pól.
W przypadku metody realizacji zamówienia powiązanej z linkiem do działania nie jest wymagana żadna opłata.
MinimumFee
Minimalna opłata wymagana w przypadku metody realizacji powiązanej z linkiem do działania.
| Zapis JSON |
|---|
{
"baseFeeAmount": {
object ( |
| Pola | |
|---|---|
baseFeeAmount |
Wymagane. Podstawowa kwota opłaty za metodę realizacji. |
FixedFee
Stała opłata wymagana w przypadku metody realizacji powiązanej z linkiem do działania.
| Zapis JSON |
|---|
{
"amount": {
object ( |
| Pola | |
|---|---|
amount |
Wymagane. Kwota opłaty stałej za metodę realizacji. |
FoodOrderingMetadata
Metadane linków do działań związanych z zamawianiem jedzenia.
| Zapis JSON |
|---|
{ "feeDetails": [ { object ( |
| Pola | |
|---|---|
feeDetails[] |
Szczegóły opłat naliczonych użytkownikowi oprócz łącznej kwoty za produkt. Powtarzane dla różnych rodzajów opłat, takich jak opłata za usługę, opłata za dostawę itp. |
advanceOrderDetails |
Szczegóły dotyczące zaawansowanej obsługi zamówień, znanej też jako zamawianie z wyprzedzeniem, w przypadku której użytkownik może złożyć zamówienie do realizacji w późniejszym terminie. |
Pole zbiorcze fulfillment_duration_options. Czas realizacji zamówienia od momentu potwierdzenia zamówienia. W przypadku zamówień z dostawą czas oczekiwania na dostarczenie jedzenia. W przypadku zamówień z odbiorem własnym czas oczekiwania na przygotowanie jedzenia. fulfillment_duration_options może mieć tylko jedną z tych wartości: |
|
fulfillmentLeadTimeDuration |
Stały czas trwania. Przykład: 30 minut. Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „ |
fulfillmentLeadTimeDurationRange |
Zakres czasu trwania. Przykłady: * 30–45 minut * ponad 30 minut * mniej niż 50 minut |
FeeDetails
Szczegóły opłaty.
| Zapis JSON |
|---|
{ "type": enum ( |
| Pola | |
|---|---|
type |
Typ opłaty. (wymagane) |
feeAmount |
Kwota opłaty podana w walucie jednostki, jako odsetek wartości koszyka lub jako połączenie obu tych wartości. (wymagane) |
FeeType
Typ opłaty.
| Wartości w polu enum | |
|---|---|
FEE_TYPE_UNSPECIFIED |
Nieokreślony typ opłaty. |
DELIVERY |
Opłaty za dostawę. |
SERVICE |
opłat za obsługę, |
FeeAmount
Przykłady wartości FeeAmount: * Opłata stała: 0 PLN (bez opłaty), 1,5 PLN * Przedział opłaty stałej: 1,0 PLN (minimum), 3,0 PLN (maksimum), 5,0–6,0 PLN * Procent wartości koszyka: 15,5%, 10–20%, 10% (minimum), 15% (maksimum) * Połączenie przedziału i procentu: 25,5% i 2,5 PLN (minimum), 25,5% i 4,5 PLN (maksimum), 10% i 1,5–2,5 PLN, 10,5–20% i 2,5–3,5 PLN
| Zapis JSON |
|---|
{ "cartPercentage": { object ( |
| Pola | |
|---|---|
cartPercentage |
Opłata jako procent wartości koszyka. Obsługuje zakres (ograniczony i nieograniczony) lub stały procent. Wartość powinna mieścić się w zakresie od 0 do 100. Przykłady: * Stała wartość 5,5% * Co najmniej 5,5% * Co najwyżej 5,5% * Od 4,5% do 5,5% |
Pole zbiorcze amount_options. Opcje określania kwoty pieniężnej. amount_options może mieć tylko jedną z tych wartości: |
|
amount |
Ustalona kwota. Na przykład 3,50 PLN. |
amountRange |
Zakres kwoty. Przykłady: * 3,5–5,5 PLN * co najmniej 3,5 PLN * co najwyżej 5,5 PLN |
amountUnknown |
Nieznana kwota. |
Pieniądze
Reprezentuje kwotę pieniędzy z określeniem typu waluty.
| Zapis JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Pola | |
|---|---|
currencyCode |
Trzyliterowy kod waluty zdefiniowany w normie ISO 4217. |
units |
Całe jednostki kwoty. Jeśli na przykład |
nanos |
Liczba jednostek nano (10^-9) kwoty. Wartość musi mieścić się w przedziale od -999 999 999 do +999 999 999 (włącznie). Jeśli wartość |
MoneyRange
Obiekt opakowujący zakres kwot pieniężnych, który może być ograniczony lub nieograniczony. Wymagana jest co najmniej jedna z wartości minAmount i maxAmount.
| Zapis JSON |
|---|
{ "minAmount": { object ( |
| Pola | |
|---|---|
minAmount |
Minimalna kwota. |
maxAmount |
Maksymalna kwota. |
QuantitativeValue
Obiekt opakowujący wartość liczbową, która może być zakresem lub stałą wartością. QuantitativeValue Przykłady: * Wartość pojedyncza: value: 10.5 * Ograniczony zakres: valueRange {minValue: 5.5, maxValue 10.5} * Dolna granica: valueRange {minValue: 5.5} * Górna granica: valueRange {maxValue: 10.5}
| Zapis JSON |
|---|
{ // Union field |
| Pola | |
|---|---|
Pole zbiorcze value_options. (wymagane) value_options może mieć tylko jedną z tych wartości: |
|
value |
pojedynczą wartość, Przykład: 5,6 |
valueRange |
Zakres wartości, który może być otwarty lub ograniczony. Przykłady: * Co najmniej 5,5 * Co najwyżej 5,5 * Od 5,5 do 6,5 |
RangeValue
Zakres wartości, tak aby minValue < maxValue. Wymaga co najmniej jednej z tych wartości: minValue i maxValue.
| Zapis JSON |
|---|
{ "minValue": number, "maxValue": number } |
| Pola | |
|---|---|
minValue |
Wartość minimalna. |
maxValue |
Wartość maksymalna. |
DurationRange
Klasa opakowująca zakres czasu trwania, który może być ograniczony lub nieograniczony. Wymagany jest co najmniej jeden z tych parametrów: minDuration i maxDuration.
| Zapis JSON |
|---|
{ "minDuration": string, "maxDuration": string } |
| Pola | |
|---|---|
minDuration |
Minimalny czas trwania. Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „ |
maxDuration |
Maksymalny czas trwania. Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „ |
AdvanceOrderDetails
Wsparcie dotyczące zamówień z wyprzedzeniem.
| Zapis JSON |
|---|
{ "isSupported": boolean } |
| Pola | |
|---|---|
isSupported |
Wartość „prawda”, jeśli zamówienia z wyprzedzeniem są obsługiwane. (wymagane) |
EventMetadata
Dodatkowe informacje o linku do działania, które są unikalne dla kategorii wydarzeń.
| Zapis JSON |
|---|
{
"surface": enum ( |
| Pola | |
|---|---|
surface |
Wstępnie określona powierzchnia zdarzenia powiązana z linkiem do działania. Jest to używane tylko w kategorii wydarzeń. |
Platforma
Wstępnie określona powierzchnia zdarzenia powiązana z linkiem do działania. Jest to używane tylko w kategorii wydarzeń.
| Wartości w polu enum | |
|---|---|
SURFACE_UNSPECIFIED |
Platforma jest nieokreślona. |
SURFACE_SEARCH |
Link do działania umożliwia rezerwację biletu na wydarzenie w wyszukiwarce. |
SURFACE_YOUTUBE |
Link do działania umożliwia rezerwację biletu na wydarzenie w YouTube. |
SURFACE_ADS |
Link do działania to kliknięcie reklamy wydarzenia. |