Order

Jednostka zamówienia. Uwaga: 1. Jeśli nie określono inaczej, wszystkie ciągi znaków na wszystkich poziomach muszą mieć mniej niż 1000 znaków. 2. Jeśli nie określono inaczej, liczba wszystkich pól powtarzanych na wszystkich poziomach musi być mniejsza niż 50. 3. Wszystkie sygnatury czasowe na wszystkich poziomach (jeśli zostały podane) muszą być prawidłowymi sygnaturami czasowymi.

Zapis JSON
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Pola
googleOrderId

string

Identyfikator zamówienia przypisany przez Google.

merchantOrderId

string

Wymagane: wewnętrzny identyfikator zamówienia przypisany przez sprzedawcę. Ten identyfikator musi być unikalny i wymagany przy kolejnych operacjach aktualizacji zamówienia. Ten identyfikator może być ustawiony na podany identyfikator googleOrderId lub dowolną inną unikalną wartość. Pamiętaj, że identyfikator przedstawiany użytkownikom to userVisibleOrderId, który może mieć inną, bardziej przyjazną dla użytkownika wartość. Maksymalna dozwolona długość to 128 znaków.

userVisibleOrderId

string

Identyfikator widoczny dla użytkownika odnoszący się do bieżącego zamówienia. Ten identyfikator powinien być spójny z identyfikatorem wyświetlanym dla tego zamówienia w innych kontekstach, m.in. na stronach internetowych, w aplikacjach i e-mailach.

userVisibleStateLabel
(deprecated)

string

Wycofane: użyj stanu OrderExtensions. Etykieta widoczna dla użytkownika stanu tego zamówienia.

buyerInfo

object (UserInfo)

Informacje o kupującym.

image

object (Image)

Obraz powiązany z zamówieniem.

createTime

string (Timestamp format)

Wymagane: data i godzina utworzenia zamówienia.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund. Przykład: "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

Data i godzina ostatniej aktualizacji zamówienia. Wymagany w przypadku aktualizacji OrderUpdate.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund. Przykład: "2014-10-02T15:01:23.045123456Z".

transactionMerchant

object (Merchant)

Sprzedawca, który umożliwił dokonanie płatności. Może się różnić od danych dostawcy na poziomie elementu zamówienia. Przykład: zamówienie Expedia z elementem zamówienia od ANA.

contents

object (Contents)

Wymagane: zawartość zamówienia będąca grupą elementów zamówienia.

priceAttributes[]

object (PriceAttribute)

Cena, rabaty, podatki itp.

followUpActions[]

object (Action)

Dalsze działania na poziomie zamówienia.

paymentData

object (PaymentData)

Dane dotyczące płatności za zamówienie.

termsOfServiceUrl

string

Link do warunków korzystania z usługi dotyczących zamówienia lub proponowanego zamówienia.

note

string

Uwagi dołączone do zamówienia.

promotions[]

object (Promotion)

Wszystkie promocje powiązane z tym zamówieniem.

disclosures[]

object (Disclosure)

Wymagane oświadczenia dotyczące tego zamówienia.

vertical
(deprecated)

object

Wycofane: zamiast tego użyj kategorii. Właściwości te będą mieć zastosowanie do wszystkich elementów zamówienia, chyba że zostaną zastąpione w którymś z nich. Ta branża musi odpowiadać typowi branży na poziomie elementu zamówienia. Możliwe wartości: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

Pole sumy verticals. Właściwości te będą mieć zastosowanie do wszystkich elementów zamówienia, chyba że zostaną zastąpione w którymś z nich. Ta branża musi odpowiadać typowi branży na poziomie elementu zamówienia. verticals może mieć tylko jedną z tych wartości:
purchase

object (PurchaseOrderExtension)

Zamówienie kupna

ticket

object (TicketOrderExtension)

Zamówienie biletów

UserInfo

Informacje o użytkowniku. Służy do reprezentowania informacji o użytkowniku powiązanym z zamówieniem.

Zapis JSON
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
Pola
email

string

Adres e-mail użytkownika, np. janedoe@gmail.com.

firstName

string

Imię użytkownika.

lastName

string

Nazwisko użytkownika.

displayName

string

Wyświetlana nazwa użytkownika może być inna niż imię lub nazwisko.

phoneNumbers[]

object (PhoneNumber)

Numery telefonu użytkownika.

Numer telefonu

Przedstawienie standardowego numeru telefonu.

Zapis JSON
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
Pola
e164PhoneNumber

string

Numer telefonu w formacie E.164 zgodnie z definicją w zaleceniu E.164 Międzynarodowego Związku Telekomunikacyjnego (ITU). Link do strony wiki: https://en.wikipedia.org/wiki/E.164

extension

string

Rozszerzenie nie jest ustandaryzowane w rekomendacjach ITU z wyjątkiem serii liczb o maksymalnej długości 40 cyfr. Jest to zdefiniowany tutaj ciąg, który ma na celu uwzględnienie ewentualnego zera na początku rozszerzenia (organizacje mają pełną swobodę, ponieważ nie mają zdefiniowanego standardu). Inne niż cyfry i niektóre inne znaki wybierania, np. „,” (co oznacza czas oczekiwania). Na przykład w formacie xxx-xxx-xxxx wew. 123, „123” to rozszerzenie.

preferredDomesticCarrierCode

string

Kod wyboru operatora, który jest preferowany podczas nawiązywania połączeń z tym numerem w kraju. Dotyczy to również kodów, do których należy zadzwonić w niektórych krajach, gdy dzwonisz z telefonów stacjonarnych na telefony komórkowe lub na odwrót. Na przykład w Kolumbii wartość „3” trzeba wybrać numer przed samym numerem telefonu, gdy dzwonisz z telefonu komórkowego na krajowy telefon stacjonarny, i na odwrót. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Pamiętaj, że ta opcja jest „preferowana”. co oznacza, że inne kody też mogą działać.

Obraz

Obraz wyświetlany na karcie.

Zapis JSON
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
Pola
url

string

Źródłowy adres URL obrazu. Obrazy mogą być w formacie JPG, PNG lub GIF (animowane lub nieanimowane). Na przykład: https://www.agentx.com/logo.png. Wymagane.

accessibilityText

string

Opis tekstowy obrazu, który ma być używany na potrzeby ułatwień dostępu, np. przez czytniki ekranu. Wymagane.

height

number

Wysokość obrazu w pikselach. Opcjonalnie:

width

number

Szerokość obrazu w pikselach. Opcjonalnie:

Sprzedawca

Sprzedawca dla koszyka/zamówienia/elementu zamówienia.

Zapis JSON
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
Pola
id

string

Opcjonalny identyfikator przypisany do sprzedawcy.

name

string

Nazwa sprzedawcy, np. „Panera Chleb”.

image

object (Image)

Zdjęcie powiązane ze sprzedawcą.

phoneNumbers[]

object (PhoneNumber)

Numery telefonów sprzedawcy.

address

object (Location)

Adres sprzedawcy.

Lokalizacja

Kontener reprezentujący lokalizację.

Zapis JSON
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
Pola
coordinates

object (LatLng)

Współrzędne geograficzne. Wymaga: [DEVICE_PRECISE_LOCATION] uprawnienie [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

formattedAddress

string

Wyświetl adres, np. „Rynek Główny 12, 31-042 Kraków”. Wymaga: [DEVICE_PRECISE_LOCATION] uprawnienie [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

zipCode

string

Kod pocztowy. Wymaga: [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] lub [DEVICE_COARSE_LOCATION] uprawnienie [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

city

string

Miasto. Wymaga: [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] lub [DEVICE_COARSE_LOCATION] uprawnienie [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

postalAddress

object (PostalAddress)

Adres pocztowy. Wymaga: [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] lub [DEVICE_COARSE_LOCATION] uprawnienie [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

name

string

Nazwa miejsca.

phoneNumber

string

Numer telefonu lokalizacji, np. numer kontaktowy lokalizacji firmy lub numer telefonu miejsca dostawy.

notes

string

Notatki o lokalizacji.

placeId

string

Identyfikator PlaceId jest używany z interfejsem Places API do pobierania szczegółowych informacji o miejscu. Zobacz https://developers.google.com/places/web-service/place-id

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest to para podwójnej precyzji reprezentująca stopnie szerokości i długości geograficznej. O ile nie wskazano inaczej, ten identyfikator musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w znormalizowanych zakresach.

Zapis JSON
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0, +90,0].

longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie od -180,0 do +180,0].

PostalAddress

Reprezentuje adres pocztowy, np. adresów dostawy lub płatności. Jeśli podasz adres pocztowy, firma pocztowa może dostarczyć przesyłki do placówki Twojej firmy. Box lub podobnego. Nie służy on do modelowania lokalizacji geograficznych (dróg, miast, gór).

W większości przypadków adres jest tworzony na podstawie danych wejściowych użytkownika lub importowanych istniejących danych, w zależności od typu procesu.

Porady dotyczące wpisywania / edytowania adresu: – skorzystaj z widżetu adresu i18n-ready, np. https://github.com/google/libaddressinput – nie należy wyświetlać użytkownikom elementów interfejsu do wprowadzania lub edytowania pól spoza krajów, w których jest ono używane.

Więcej wskazówek dotyczących korzystania z tego schematu znajdziesz na stronie https://support.google.com/business/answer/6397478

Zapis JSON
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Pola
revision

number

Wersja schematu tabeli PostalAddress. Wartość ta musi wynosić 0, co jest najnowszą wersją.

Wszystkie nowe wersje muszą być zgodne wstecznie ze starymi.

regionCode

string

Wymagane. Kod regionu CLDR kraju lub regionu adresu. Nie są one nigdy wnioskowane i to użytkownik musi upewnić się, że wartość jest prawidłowa. Szczegółowe informacje można znaleźć na stronach http://cldr.unicode.org/ i http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: „CH”. dla Szwajcarii.

languageCode

string

Opcjonalnie: Kod języka BCP-47 treści adresu (jeśli jest znany). Często jest to język interfejsu formularza wejściowego lub prawdopodobnie jeden z języków używanych w adresie kraj/region lub ich transliterowane odpowiedniki. Może to wpłynąć na formatowanie w niektórych krajach, ale nie ma wpływu na prawidłowość danych i nigdy nie wpływa na weryfikację ani inne operacje związane z nieformatowaniem.

Jeśli ta wartość nie jest znana, należy ją pominąć (zamiast określać potencjalnie nieprawidłową wartość domyślną).

Przykłady: „zh-Hant”, „ja”, „ja-Latn”, „pl”.

postalCode

string

Opcjonalnie: Kod pocztowy adresu. Nie wszystkie kraje używają kodów pocztowych lub ich wymagają, ale tam, gdzie są używane, mogą powodować dodatkową weryfikację innych części adresu (np. stan lub kod pocztowy w Stanach Zjednoczonych).

sortingCode

string

Opcjonalnie: Dodatkowy kod sortowniczy specyficzny dla kraju. Nie jest on używany w większości regionów. Ta wartość jest ciągiem znaków takim jak „CEDEX”, po którym może występować liczba (np. „CEDEX 7”), lub samej liczby reprezentującej „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (Malawi) lub „wskaźnik urzędu pocztowego” (np. Wybrzeże Kości Słoniowej).

administrativeArea

string

Opcjonalnie: Najwyższy podział administracyjny stosowany w przypadku adresów pocztowych kraju lub regionu. Na przykład stan, prowincja, obwód lub prefektura. W przypadku Hiszpanii jest to prowincja, a nie wspólnota autonomiczna (np. „Barcelona”, nie „Katalonia”). Wiele krajów nie używa regionu w adresach pocztowych. Na przykład: w Szwajcarii pole musi być puste.

locality

string

Opcjonalnie: Zasadniczo odnosi się do części miejscowości lub miejscowości. Przykłady: USA, gmina IT, poczta polska. W regionach, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury, zostaw pole Rejon puste, a następnie użyj addressLines.

sublocality

string

Opcjonalnie: Okręg, w którym znajduje się adres. Na przykład mogą to być dzielnice, dystrykty, okręgi.

addressLines[]

string

Nieuporządkowane wiersze adresu opisujące dolne poziomy adresu.

Wartości w addressLine nie mają informacji o typie i czasami mogą zawierać wiele wartości w jednym polu (np. „Austin, TX”), ważne jest, aby kolejność wierszy była jasna. Kolejność wierszy adresu powinna być określona jako „kolejność danych koperty”. zgodnie z krajem/regionem adresu. Tam, gdzie może być to inne (np. w Japonii), słowo address_language jest używane do jednoznacznego określenia (np. „ja” dla sortowania w dużym i małym porządku oraz „ja-Latn” lub „en” dla małych i dużych). Dzięki temu można wybrać najbardziej precyzyjny wiersz adresu na podstawie języka.

Minimalna dozwolona reprezentacja strukturalna adresu składa się z kodu regionu RegionCode, a wszystkie pozostałe informacje są umieszczane w elemencie addressLines. Sformatowanie takiego adresu w przybliżeniu bez geokodowania byłoby możliwe, ale semantyczne rozumowanie nie byłoby możliwe w odniesieniu do żadnego ze składników adresu, dopóki nie zostanie przynajmniej częściowo rozpatrzone.

Zalecanym sposobem obsługi adresów całkowicie nieuporządkowanych

recipients[]

string

Opcjonalnie: Adresat pod adresem. W pewnych okolicznościach to pole może zawierać informacje obejmujące wiele wierszy. Może na przykład zawierać hasło „opieka” i informacjami o nich.

organization

string

Opcjonalnie: Nazwa organizacji pod adresem.

Spis treści

Paczka z elementami zamówienia.

Zapis JSON
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Pola
lineItems[]

object (LineItem)

Lista elementów zamówienia. Wymagany jest co najmniej 1 element zamówienia, ale maksymalna dozwolona liczba to 50. Wszystkie elementy zamówienia muszą należeć do tej samej branży.

LineItem

1 element zamówienia zawiera 1 branżę. Zamówienie lub koszyk może zawierać wiele elementów zamówienia z tej samej branży. Podrzędne elementy zamówienia, dodatki itp. powinny być zdefiniowane jako pionowe w zależności od przypadków użycia. Uwaga: 1. Jeśli nie określono inaczej, wszystkie ciągi znaków na wszystkich poziomach muszą mieć mniej niż 1000 znaków. 2. Jeśli nie określono inaczej, liczba wszystkich pól powtarzanych na wszystkich poziomach musi być mniejsza niż 50. 3. Wszystkie sygnatury czasowe na wszystkich poziomach (jeśli zostały podane) muszą być prawidłowymi sygnaturami czasowymi.

Zapis JSON
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
Pola
id

string

Wymagane: identyfikator elementu zamówienia przypisany przez sprzedawcę. Służy do identyfikowania istniejącego elementu zamówienia podczas stosowania częściowych aktualizacji. Maksymalna dozwolona długość to 64 znaki.

name

string

Nazwa pozycji widniejąca na potwierdzeniu. Maksymalna dozwolona długość to 100 znaków.

userVisibleStateLabel
(deprecated)

string

Rola wycofana. Zamiast tego użyj stanu na poziomie branży. W przypadku zakupów użyj np. PurchaseOrderExtension.status. Etykieta widoczna dla użytkownika stanu tego elementu zamówienia.

provider

object (Merchant)

Dostawca konkretnego elementu zamówienia, jeśli różni się od ogólnego zamówienia. Przykład: zamówienie Expedia z ANA dostawcy elementu zamówienia.

priceAttributes[]

object (PriceAttribute)

Cena i dostosowania na poziomie elementu zamówienia.

followUpActions[]

object (Action)

Działania związane z elementem zamówienia.

recipients[]

object (UserInfo)

Klienci na poziomie elementu zamówienia może się różnić od kupującego na poziomie zamówienia. Przykład: użytkownik X dokonał rezerwacji w restauracji na imię i nazwisko użytkownika Y.

image

object (Image)

Mały obraz powiązany z tym elementem (jeśli taki istnieje).

description

string

Opis elementu zamówienia.

notes[]

string

Dodatkowe uwagi dotyczące tego konkretnego elementu zamówienia, na przykład zasady anulowania.

disclosures[]

object (Disclosure)

Oświadczenia związane z tym elementem zamówienia.

vertical
(deprecated)

object

Wycofane: zamiast tego użyj kategorii. Wymagane: semantyczna zawartość elementu zamówienia według jego typu lub branży. Każda branża powinna zawierać własne szczegóły realizacji zamówienia. Musi to być jedna z tych wartości: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

Pole sumy verticals. Wymagane: semantyczna zawartość elementu zamówienia według jego typu lub branży. Każda branża powinna zawierać własne szczegóły realizacji zamówienia. verticals może mieć tylko jedną z tych wartości:
purchase

object (PurchaseItemExtension)

Zamówienia na towary, jedzenie itp.

reservation

object (ReservationItemExtension)

Rezerwacje, np. w restauracji, strzyżeniu itp.

PriceAttribute

Atrybut cena zamówienia lub elementu zamówienia.

Zapis JSON
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": number
  // End of list of possible types for union field spec.
}
Pola
type

enum (Type)

Wymagany: atrybut typ pieniędzy.

name

string

Wymagane: użytkownik wyświetlił ciąg znaków z atrybutu cena. Ta informacja jest wysyłana i zlokalizowana przez sprzedawcę.

state

enum (State)

Wymagane: stan ceny: szacunkowa a rzeczywista.

taxIncluded

boolean

Określa, czy cena jest uwzględniona w podatku.

Pole sumy spec. Oznacza kwotę pieniężną lub procent. spec może mieć tylko jedną z tych wartości:
amount

object (Money)

Kwota pieniężna.

amountMillipercentage
(deprecated)

number

Specyfikacja procentowa do 1/1000. Przykład: 8,750% jest przedstawione jako 8750, a ujemne wartości procentowe oznaczają rabaty procentowe. Wycofuję to pole. Rozważ dodanie go ponownie, gdy wymagane jest solidne zastosowanie.

Typ

Reprezentuje typ pieniędzy.

Wartości w polu enum
TYPE_UNSPECIFIED Typ nie jest określony. Klienci nie powinni tego bezpośrednio ustawiać.
REGULAR Wyświetlana cena standardowa, przed zastosowaniem rabatów itp.
DISCOUNT Do odliczenia od sumy częściowej.
TAX Zostanie dodany do sumy częściowej.
DELIVERY Zostanie dodany do sumy częściowej.
SUBTOTAL Suma częściowa przed uwzględnieniem niektórych opłat.
FEE Wszelkie dodatkowe opłaty.
GRATUITY Zostanie dodany do sumy częściowej.
TOTAL Wyświetlana cena zamówienia lub elementu zamówienia.

Stan

Reprezentuje stan ceny.

Wartości w polu enum
STATE_UNSPECIFIED Nie określono.
ESTIMATE Jest to tylko szacowana cena.
ACTUAL Rzeczywista cena, jaką zostanie obciążony użytkownik.

Pieniądze

Reprezentuje kwotę za pomocą jej typu waluty.

Zapis JSON
{
  "currencyCode": string,
  "amountInMicros": string
}
Pola
currencyCode

string

Trzyliterowy kod waluty zdefiniowany w normie ISO 4217.

amountInMicros

string (int64 format)

Ilość w mikro. np.w tym polu należy ustawić wartość 1990000, czyli 1,99 PLN.

Działanie

Działanie powiązane z zamówieniem lub elementem zamówienia.

Zapis JSON
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Pola
type

enum (Type)

Wymagany: typ działania.

title

string

Tytuł lub etykieta działania wyświetlana użytkownikowi. Maksymalna dozwolona długość to 100 znaków.

openUrlAction

object (OpenUrlAction)

Zalecane działania.

actionMetadata

object (ActionMetadata)

Metadane powiązane z działaniem.

Typ

Możliwe dalsze działania.

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślone działanie.
VIEW_DETAILS Wyświetlenie szczegółów zamówienia.
MODIFY Zmodyfikuj działanie związane z zamówieniem.
CANCEL Anuluj zamówienie.
RETURN Czynność dotycząca zwrotu zamówienia.
EXCHANGE Działanie związane z zamówieniem giełdy.
EMAIL

Działanie e-maila. Typy EMAIL i CALL zostały wycofane. Jako numeru telefonu lub adresu e-mail można użyć parametru openUrlAction.url.

CALL

Wezwanie do działania.

REORDER Zmień kolejność.
REVIEW Sprawdź działanie związane z zamówieniem.
CUSTOMER_SERVICE Skontaktuj się z obsługą klienta.
FIX_ISSUE Aby rozwiązać problem, otwórz stronę lub aplikację sprzedawcy.
DIRECTION Link do wskazówek dojazdu.

OpenUrlAction

Otwiera podany adres URL.

Zapis JSON
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Pola
url

string

Pole adresu URL, którym może być dowolny z tych elementów: – adresy URL http/https służące do otwierania aplikacji powiązanej z aplikacją lub strony internetowej

androidApp

object (AndroidApp)

Informacje o aplikacji na Androida, jeśli adres URL ma być wypełniany przez aplikację na Androida.

urlTypeHint

enum (UrlTypeHint)

Wskazuje wskazówkę dotyczącą typu adresu URL.

AndroidApp

Specyfikacja aplikacji na Androida pod kątem ograniczeń realizacji zamówień

Zapis JSON
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
Pola
packageName

string

Podczas definiowania realizacji na Androidzie musisz podać nazwę pakietu.

versions[]

object (VersionFilter)

Jeśli określisz wiele filtrów, każde dopasowanie filtra spowoduje uruchomienie aplikacji.

VersionFilter

Jeśli wymagane są określone wersje aplikacji, należy dodać filtr VersionFilter.

Zapis JSON
{
  "minVersion": number,
  "maxVersion": number
}
Pola
minVersion

number

Kod wersji minimalnej lub wartość 0 włącznie.

maxVersion

number

Maksymalny kod wersji. Uwzględniany zakres to [minVersion:maxVersion]. Zakres null oznacza dowolną wersję. Przykłady: aby określić jedną wersję, użyj ciągu [target_version:target_version]. Aby określić wersję, pozostaw właściwości minVersion i maxVersion nieokreślone. Aby określić wszystkie wersje do wersji maxVersion, pozostaw wartość minVersion nieokreśloną. Aby określić wszystkie wersje z parametru minVersion, pozostaw wartość maxVersion nieokreśloną.

UrlTypeHint

Różne typy wskazówek dotyczących adresów URL.

Wartości w polu enum
URL_TYPE_HINT_UNSPECIFIED Nie określono
AMP_CONTENT Adres URL, który prowadzi bezpośrednio do treści AMP lub do kanonicznego adresu URL odwołującego się do treści AMP za pomocą tagu <link rel="amphtml">.

ActionMetadata

Powiązane metadane dla każdego działania

Zapis JSON
{
  "expireTime": string
}
Pola
expireTime

string (Timestamp format)

Czas, kiedy to działanie wygaśnie.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund. Przykład: "2014-10-02T15:01:23.045123456Z".

Informacje

Informacje o produkcie, usłudze lub zasadach, które mogą zostać przedstawione użytkownikowi.

Zapis JSON
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
Pola
title

string

Tytuł dokumentu informacyjnego. Przykład: „Informacje dotyczące bezpieczeństwa”.

disclosureText

object (DisclosureText)

Treść dokumentu informacyjnego. Linki internetowe są dozwolone.

presentationOptions

object (DisclosurePresentationOptions)

Opcje prezentacji dokumentu informacyjnego

DisclosureText

Reprezentuje zwykły tekst z linkami sieciowymi.

Zapis JSON
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
Pola
template

string

Tekst do wyświetlenia zawierający obiekty zastępcze, takie jak „{0}” i „{1}” dla każdego linku tekstowego, który chcesz wstawić. Przykład: „OSTRZEŻENIE: ten produkt może narazić Cię na działanie substancji chemicznych, o których wiadomo, że powodują raka w stanie Kalifornia. Aby uzyskać więcej informacji, przejdź do {0}." Tekst komunikatu nie może zawierać żadnych treści promocyjnych ani reklam.

DisclosurePresentationOptions

Opcje wyświetlania oświadczenia

Zapis JSON
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
Pola
presentationRequirement

enum (PresentationRequirement)

Wymóg prezentacji dokumentu informacyjnego.

initiallyExpanded

boolean

Określa, czy treść powiadomienia powinna zostać początkowo rozszerzona. Domyślnie jest ona początkowo zwinięta.

PresentationRequirement

Wymóg przedstawienia dokumentu informacyjnego

Wartości w polu enum
REQUIREMENT_UNSPECIFIED Nieokreślone wymaganie. Nie należy ustawiać tego ustawienia bezpośrednio.
REQUIREMENT_OPTIONAL Komunikat wyświetlany w reklamie jest opcjonalny. Możesz go pominąć, jeśli urządzenie nie obsługuje wyświetlania oświadczeń.
REQUIREMENT_REQUIRED Wymagane oświadczenie. Jeśli urządzenie nie obsługuje wyświetlania oświadczeń, rozmowa zostanie przekierowana na telefon.

PurchaseItemExtension

Treść elementu zamówienia w kategorii Zakup.

Zapis JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
Pola
status

enum (PurchaseStatus)

Wymagany: stan na poziomie elementu zamówienia.

userVisibleStatusLabel

string

Wymagane: użytkownik widzi etykietę/ciąg znaków stanu. Maksymalna dozwolona długość to 50 znaków.

type

enum (PurchaseType)

Wymagany: typ zakupu.

productId
(deprecated)

string

Identyfikator produktu lub oferty powiązany z tym elementem zamówienia.

quantity

number

Liczba sztuk produktu.

unitMeasure

object (MerchantUnitMeasure)

Miara jednostki. Określa rozmiar produktu w wybranych jednostkach. Rozmiar w połączeniu z aktywną ceną służy do określenia ceny jednostkowej.

returnsInfo

object (PurchaseReturnsInfo)

Zwraca informacje o tym elemencie zamówienia. Jeśli zasada jest nieskonfigurowana, ten element zamówienia dziedziczy informacje o zwrotach na poziomie zamówienia.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informacje o realizacji tego elementu zamówienia. Jeśli nie jest skonfigurowana, ten element zamówienia dziedziczy informacje o realizacji na poziomie zamówienia.

itemOptions[]

object (ItemOption)

dodatkowe dodatki lub elementy podrzędne;

extension

object

dodatkowe pola wymienione między sprzedawcą a Google.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

productDetails

object (ProductDetails)

Informacje o produkcie.

PurchaseStatus

Stan zakupu powiązany z zamówieniem lub konkretnym elementem zamówienia.

Wartości w polu enum
PURCHASE_STATUS_UNSPECIFIED Stan nieokreślony.
READY_FOR_PICKUP Gotowe do odbioru.
SHIPPED Wysłano.
DELIVERED Dostarczono.
OUT_OF_STOCK Niedostępny.
IN_PREPARATION „IN_PREPARATION” w różnym kontekście może mieć różne znaczenie. W przypadku zamówienia JEDZENIE może to oznaczać, że jedzenie jest przygotowywane. W przypadku handlu detalicznego może to być spowodowane pakowaniem produktu.
CREATED Utworzono zamówienie.
CONFIRMED Sprzedawca potwierdził zamówienie.
REJECTED Sprzedawca odrzucił zamówienie lub element zamówienia.
RETURNED Produkt został zwrócony przez użytkownika.
CANCELLED Zamówienie lub element zamówienia zostały anulowane przez użytkownika.
CHANGE_REQUESTED Użytkownik poprosił o zmianę zamówienia. Integrator przetwarza tę zmianę. Po przetworzeniu żądania zamówienie powinno zostać przeniesione do innego stanu.

PurchaseType

Kategoria zakupu.

Wartości w polu enum
PURCHASE_TYPE_UNSPECIFIED Nieznana wartość.
RETAIL Obejmuje to zakupy, np. produkty fizyczne.
FOOD Obejmuje to zamawianie jedzenia.
GROCERY zakup produktu spożywczego,
MOBILE_RECHARGE Przedpłacone doładowanie telefonu komórkowego.

MerchantUnitMeasure

Miara ceny jednostkowej sprzedawcy.

Zapis JSON
{
  "measure": number,
  "unit": enum (Unit)
}
Pola
measure

number

Wartość: przykład 1.2.

unit

enum (Unit)

Jednostka: przykładowa wartość POUND, GRAM.

Jednostka

Wartości w polu enum
UNIT_UNSPECIFIED Nie określono jednostki.
MILLIGRAM Miligram.
GRAM Gram.
KILOGRAM Kilogram.
OUNCE Uncja.
POUND Funt.

PurchaseReturnsInfo

Zwraca informacje powiązane z zamówieniem lub konkretnym elementem zamówienia.

Zapis JSON
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
Pola
isReturnable

boolean

Jeśli ma wartość true (prawda), zwracanie jest dopuszczalne.

daysToReturn

number

Po upływie takiej liczby dni można dokonać zwrotu.

policyUrl

string

Link do zasad zwrotów.

PurchaseFulfillmentInfo

Informacje o realizacji związane z zamówieniem lub konkretnym elementem zamówienia.

Zapis JSON
{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
Pola
id

string

Unikalny identyfikator tej opcji usługi.

fulfillmentType

enum (Type)

Wymagane: rodzaj realizacji.

expectedFulfillmentTime

object (Time)

Okno, jeśli został określony zakres czasu, lub szacowany czas dotarcia, jeśli został określony pojedynczy czas. Oczekiwany czas dostawy lub odbioru.

expectedPreparationTime

object (Time)

Okno, jeśli został określony zakres czasu, lub szacowany czas dotarcia, jeśli został określony pojedynczy czas. Ilość czasu potrzebnego na przygotowanie jedzenia. Preferowane jednorazowo.

location

object (Location)

Miejsce odbioru lub dostawy.

expireTime

string (Timestamp format)

Czas, po którym ta opcja realizacji zamówienia wygaśnie.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund. Przykład: "2014-10-02T15:01:23.045123456Z".

price

object (PriceAttribute)

Koszt tej opcji.

fulfillmentContact

object (UserInfo)

Kontakt użytkownika na potrzeby tej realizacji.

shippingMethodName

string

Nazwa metody dostawy wybranej przez użytkownika.

storeCode

string

Kod sklepu lokalizacji. Przykład: Walmart to sprzedawca, a kod sklepu to sklep Walmart, w którym doszło do realizacji transakcji. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

Dodatkowe informacje o sposobie wybierania zamówienia. To pole ma zastosowanie tylko wtedy, gdy typem realizacji jest ODBIERZ.

Typ

Typ realizacji.

Wartości w polu enum
TYPE_UNSPECIFIED Nie określono typu.
DELIVERY To zamówienie zostanie dostarczone.
PICKUP To zamówienie należy odebrać.

Godzina

Format czasu do reprezentowania czasu zdarzenia, który ma być używany podczas wyświetlania zamówienia użytkownikowi.

Zapis JSON
{
  "timeIso8601": string
}
Pola
timeIso8601

string

Reprezentuje godzinę zdarzenia zamówienia, np. godzinę rezerwacji, czas dostawy itp. Może to być czas trwania (czas rozpoczęcia i zakończenia), tylko data, data i godzina. Listę wszystkich obsługiwanych formatów znajdziesz na https://en.wikipedia.org/wiki/ISO_8601.

PickupInfo

Szczegóły dotyczące odbioru zamówienia. Zawiera on informacje takie jak typ odbioru oraz dodatkowe metadane dołączone do każdego typu, jeśli są dostępne.

Zapis JSON
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Pola
pickupType

enum (PickupType)

Metoda odbioru, np. INSTORE, CURBSIDE itp.

curbsideInfo

object (CurbsideInfo)

Szczegóły dotyczące informacji znajdujących się na zewnątrz. Jeśli pickupType ma wartość „CURBSIDE”, to pole zostanie zignorowane.

checkInInfo[]

object (CheckInInfo)

Lista różnych metod obsługiwanych przez partnera, które obsługują odprawę.

PickupType

Lista obsługiwanych typów odbioru.

Wartości w polu enum
UNSPECIFIED Nieokreślony typ odbioru.
INSTORE Odbierz je w restauracji.
CURBSIDE Zaparkuj pojazd w wyznaczonym miejscu przed restauracją, aby ktoś mógł dostarczyć tam jedzenie.

CurbsideInfo

Szczegóły dotyczące ułatwienia składania zamówień na zewnątrz.

Zapis JSON
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Pola
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

Partnerzy potrzebują dodatkowych informacji, aby ułatwić zamówienia z odbiorem na zewnątrz. W zależności od wybranego typu realizacji zamówienia odpowiednie informacje będą zbierane od użytkownika.

userVehicle

object (Vehicle)

Dane pojazdu należącego do użytkownika składającego zamówienie.

CurbsideFulfillmentType

Możliwe wartości typów realizacji na zewnątrz.

Wartości w polu enum
UNSPECIFIED Typ realizacji na zewnątrz nieokreślony.
VEHICLE_DETAIL Szczegóły pojazdu wymagane, aby umożliwić odbiór na zewnątrz.

Pojazd

Szczegółowe informacje o pojeździe

Zapis JSON
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
Pola
make

string

Marka pojazdu (np. „Honda”). Nazwa jest wyświetlana użytkownikowi i musi być zlokalizowana. Wymagane.

model

string

Model pojazdu (np. „Grom”). Nazwa jest wyświetlana użytkownikowi i musi być zlokalizowana. Wymagane.

licensePlate

string

Numer rejestracyjny pojazdu (np. „1ABC234”). Wymagane.

colorName

string

Nazwa koloru pojazdu, np. czarny Opcjonalny.

image

object (Image)

Adres URL zdjęcia pojazdu. Zdjęcie będzie wyświetlane w rozmiarze około 256 x 256 pikseli. Musi to być plik JPG lub PNG. Opcjonalnie:

CheckInInfo

Metadane wymagane przez partnera do obsługi metody zameldowania.

Zapis JSON
{
  "checkInType": enum (CheckInType)
}
Pola
checkInType

enum (CheckInType)

Metoda użyta do wysłania instrukcji dotyczących meldowania się.

CheckInType

Różne metody wysyłania instrukcji dotyczących meldowania się.

Wartości w polu enum
CHECK_IN_TYPE_UNSPECIFIED Nieznana wartość.
EMAIL Informacje dotyczące zameldowania zostaną wysłane e-mailem.
SMS Informacje o meldowaniu będą wysyłane SMS-em.

ItemOption

Reprezentuje dodatki lub elementy podrzędne.

Zapis JSON
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Pola
id

string

W przypadku opcji dotyczących produktów: unikalny identyfikator produktu.

name

string

Nazwa opcji.

prices[]

object (PriceAttribute)

Łączna cena opcji.

note

string

Uwaga dotycząca opcji.

quantity

number

Jeśli chodzi o opcje dotyczące produktów i liczby,

productId

string

Identyfikator produktu lub oferty powiązany z tą opcją.

subOptions[]

object (ItemOption)

Aby zdefiniować inne zagnieżdżone opcje podrzędne.

ProductDetails

Informacje o produkcie.

Zapis JSON
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Pola
productId

string

Identyfikator produktu lub oferty powiązany z tym elementem zamówienia.

gtin

string

Globalny numer jednostki handlowej produktu. Przydatne, jeśli w Merchant Center nie ma parametru offerId. Opcjonalnie:

plu

string

Kody wyszukiwania cen, nazywane potocznie kodami PLU, numerami PLU, PLU, kodami produkcyjnymi lub etykietami, to system liczb, które jednoznacznie identyfikują produkty hurtowe sprzedawane w sklepach spożywczych i supermarketach.

productType

string

Kategoria produktu zdefiniowana przez sprzedawcę. Na przykład: „Ekran główny > Sklep spożywczy > Nabiał Jajka > Mleko > Mleko pełne”

productAttributes

map (key: string, value: string)

Podane przez sprzedawcę informacje o produkcie, np. { &quot;allergen&quot;: &quot;peanut&quot; }. Przydatne, jeśli w Merchant Center nie ma parametru offerId. Opcjonalnie:

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Treść elementu zamówienia dla zamówień rezerwacji, takich jak restauracja, strzyżenie itp. Następny identyfikator: 15.

Zapis JSON
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
Pola
status

enum (ReservationStatus)

Wymagany: stan rezerwacji.

userVisibleStatusLabel

string

Wymagane: użytkownik widzi etykietę/ciąg znaków stanu. Maksymalna dozwolona długość to 50 znaków.

type

enum (ReservationType)

Typ rezerwacji. Wartość może być nieskonfigurowana, jeśli żadna z opcji typów nie jest dostępna.

reservationTime

object (Time)

Czas zaplanowanego wykonania usługi lub zdarzenia. Może to być zakres czasu, data lub dokładna data i godzina.

userAcceptableTimeRange

object (Time)

Zakres czasu akceptowalny dla użytkownika.

confirmationCode

string

Kod potwierdzenia tej rezerwacji.

partySize

number

Liczba osób.

staffFacilitators[]

object (StaffFacilitator)

Opiekun personelu, który będzie obsługiwać rezerwację. Np. Fryzjer

location

object (Location)

Lokalizacja usługi lub zdarzenia.

extension

object

dodatkowe pola wymienione między sprzedawcą a Google.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

ReservationStatus

Stan rezerwacji.

Wartości w polu enum
RESERVATION_STATUS_UNSPECIFIED Stan nieokreślony.
PENDING Rezerwacja oczekuje na realizację.
CONFIRMED Rezerwacja została potwierdzona.
CANCELLED Rezerwacja została anulowana przez użytkownika.
FULFILLED Rezerwacja została zrealizowana.
CHANGE_REQUESTED Wysłano prośbę o zmianę rezerwacji
REJECTED Rezerwacja wygasła lub została odrzucona przez integratora.

ReservationType

Typ rezerwacji.

Wartości w polu enum
RESERVATION_TYPE_UNSPECIFIED Nieokreślony typ.
RESTAURANT Rezerwacja w restauracji.
HAIRDRESSER Rezerwacja u fryzjera.

StaffFacilitator

Informacje o sprzedawcy.

Zapis JSON
{
  "name": string,
  "image": {
    object (Image)
  }
}
Pola
name

string

Imię i nazwisko opiekuna personelu. Np. „Jan Kowalski”

image

object (Image)

Zdjęcia wykonawcy.

PaymentData

Dane płatności związane z zamówieniem.

Zapis JSON
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Pola
paymentResult

object (PaymentResult)

Wynik płatności wykorzystywany przez integratora do zrealizowania transakcji. Jeśli proces płatności jest zarządzana przez Actions-on-Google, to pole zostanie zapełnione przez Actions on Google.

paymentInfo

object (PaymentInfo)

Informacje o płatności dotyczące zamówienia, które są przydatne w przypadku interakcji użytkownika.

PaymentResult

Wynik płatności używany przez integratora do zrealizowania transakcji.

Zapis JSON
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
Pola
Pole sumy result. Podano dane płatności Google lub formę płatności sprzedawcy. result może mieć tylko jedną z tych wartości:
googlePaymentData

string

Dane dotyczące form płatności udostępnione przez Google. Jeśli firma obsługująca płatności jest wymieniona na stronie https://developers.google.com/pay/api/, przejdź na stronę firmy obsługującej płatności, aby uzyskać więcej informacji. Szczegóły ładunku znajdziesz w dokumentacji poniżej. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Forma płatności podana przez sprzedawcę/działanie wybrana przez użytkownika.

PaymentInfo

Dane karty dotyczące złożonego zamówienia. Ten protokół zbiera informacje przydatne podczas interakcji z użytkownikiem.

Zapis JSON
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Pola
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

Wyświetlane informacje o formie płatności użytej do dokonania transakcji.

paymentMethodProvenance

enum (PaymentMethodProvenance)

Pochodzenie formy płatności użytej do dokonania transakcji. Użytkownik mógł zarejestrować tę samą formę płatności w Google i u sprzedawcy.

PaymentMethodDisplayInfo

Wynik płatności używany przez integratora do zrealizowania transakcji.

Zapis JSON
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
Pola
paymentType

enum (PaymentType)

Typ płatności.

paymentMethodDisplayName

string

Widoczna dla użytkownika nazwa formy płatności. Na przykład: VISA **** 1234 Sprawdzanie konta **** 5678

paymentMethodVoiceName

string

Nazwa formy płatności, która będzie odczytywana użytkownikowi w przypadku urządzeń z asystentem głosowym. na przykład „wiza kończąca się cyframi jeden dwa trzy cztery” lub „konto rozliczeniowe o numerze kończącym się cyframi pięć sześć siedem osiem”. Uwaga: jest to ciąg znaków zoptymalizowany pod kątem głosu, którego można używać zamiast PaymentMethodDisplayName w przypadku urządzeń z asystentem głosowym. Jeśli ten ciąg nie jest skonfigurowany, użytkownik korzysta z metody PaymentMethodDisplayName.

PaymentType

PaymentType wskazuje formę płatności używaną w przypadku formy płatności udostępnionej przez sprzedawcę. Działanie musi też zawierać wyświetlaną nazwę formy płatności.

Wartości w polu enum
PAYMENT_TYPE_UNSPECIFIED Nieokreślona forma płatności.
PAYMENT_CARD Karta kredytowa/debetowa lub przedpłacona.
BANK Formą płatności jest konto bankowe.
LOYALTY_PROGRAM Forma płatności to program lojalnościowy.
CASH Forma płatności to gotówka.
GIFT_CARD Formą płatności jest karta podarunkowa.
WALLET Portfel innej firmy, np. PayPal

PaymentMethodProvenance

Określa pochodzenie formy płatności użytej do dokonania transakcji.

Wartości w polu enum
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED Pochodzenie nie jest określone.
PAYMENT_METHOD_PROVENANCE_GOOGLE Pochodzenie to Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT Pochodzenie to sprzedawca.

Promocja

Promocje/oferty dodane do koszyka.

Zapis JSON
{
  "coupon": string
}
Pola
coupon

string

Wymagane: kod kuponu został zastosowany do tej oferty.

PurchaseOrderExtension

Rozszerzenie zamówienia dla kategorii zakupów. Te właściwości mają zastosowanie do wszystkich elementów zamówienia, chyba że zostaną zastąpione w elemencie zamówienia.

Zapis JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
Pola
status

enum (PurchaseStatus)

Wymagane: ogólny stan zamówienia.

userVisibleStatusLabel

string

Użytkownik widzi etykietę/ciąg znaków stanu. Maksymalna dozwolona długość to 50 znaków.

type

enum (PurchaseType)

Wymagany: typ zakupu.

returnsInfo

object (PurchaseReturnsInfo)

Informacje o zwrocie zamówienia.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informacje o realizacji zamówienia.

extension

object

dodatkowe pola wymienione między sprzedawcą a Google.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

purchaseLocationType

enum (PurchaseLocationType)

miejsce zakupu (w sklepie / online);

errors[]

object (PurchaseError)

Opcjonalnie: błędy, z powodu których zamówienie zostało odrzucone.

PurchaseLocationType

Typ lokalizacji zakupu.

Wartości w polu enum
UNSPECIFIED_LOCATION Nieznana wartość.
ONLINE_PURCHASE Wszystkie zakupy kupione online.
INSTORE_PURCHASE Wszystkie zakupy w sklepie.

PurchaseError

Błędy, z powodu których zamówienie może zostać odrzucone.

Zapis JSON
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": number
}
Pola
type

enum (ErrorType)

Wymagane: szczegółowy powód odrzucenia zamówienia przez sprzedawcę.

description

string

Dodatkowy opis błędu.

entityId

string

Identyfikator jednostki, której dotyczy błąd. Przykładowe wartości mogą odpowiadać wartości LineItemId / ItemOptionId.

updatedPrice

object (PriceAttribute)

Problem dotyczy typu błędu PRICE_CHANGED lub INCORRECT_PRICE.

availableQuantity

number

Dostępna ilość. Obowiązuje w przypadku AVAILABILITY_CHANGED.

ErrorType

Możliwe typy błędów.

Wartości w polu enum
ERROR_TYPE_UNSPECIFIED Nieznany błąd
NOT_FOUND Nie znaleziono elementu. Możliwe wartości to Item, FulfillmentOption, Promotion. Identyfikator jednostki jest wymagany.
INVALID Dane encji są nieprawidłowe. to Item, FulfillmentOption, Promotion. Identyfikator jednostki jest wymagany.
AVAILABILITY_CHANGED Produkt jest niedostępny lub ilość produktów jest niewystarczająca, aby zrealizować żądanie. Identyfikator jednostki jest wymagany.
PRICE_CHANGED Cena produktu różni się od ceny w elemencie. Wymagany jest identyfikator jednostki i zaktualizowana cena.
INCORRECT_PRICE Błędy związane z cenami w kolumnie Opłaty (łącznie). Wymagany jest identyfikator jednostki i zaktualizowana cena.
REQUIREMENTS_NOT_MET Ograniczenia dotyczące przyjmowania zamówień – minimalny rozmiar koszyka itp.
TOO_LATE Opcja FulfillmentOption wygasła.
NO_CAPACITY Brak dostępnej wydajności usług.
INELIGIBLE Użytkownik nie może złożyć zamówienia (na czarnej liście).
OUT_OF_SERVICE_AREA Dostawa pod wskazany adres jest niemożliwa ze względu na reguły graniczne itp.
CLOSED Restauracja jest zamknięta w czasie składania zamówienia.
PROMO_NOT_APPLICABLE Ogólny kod błędu wykrywający wszystkie przypadki niezastosowania kodu promocyjnego, jeśli żaden z poniższych nie pasuje. Dodaj kod promocyjny jako identyfikator jednostki.
PROMO_NOT_RECOGNIZED Kod kuponu nie został rozpoznany przez partnera. Dodaj kod promocyjny jako identyfikator jednostki.
PROMO_EXPIRED Nie można zastosować, ponieważ promocja wygasła. Dodaj kod promocyjny jako identyfikator jednostki.
PROMO_USER_INELIGIBLE Bieżący użytkownik nie może skorzystać z tego kuponu. Dodaj kod promocyjny jako identyfikator jednostki.
PROMO_ORDER_INELIGIBLE To zamówienie nie kwalifikuje się do wykorzystania tego kuponu. Dodaj kod promocyjny jako identyfikator jednostki.
UNAVAILABLE_SLOT Termin zamówienia z wyprzedzeniem jest niedostępny.
FAILED_PRECONDITION Ograniczenia dotyczące przyjmowania zamówień nie zostały spełnione – minimalny rozmiar koszyka itp.
PAYMENT_DECLINED Nieprawidłowa płatność.
MERCHANT_UNREACHABLE Sprzedawca jest nieosiągalny. Jest to przydatne, gdy partner jest pośrednikiem i nie może skontaktować się ze sprzedawcą.

TicketOrderExtension

Zamawiaj treści dotyczące zamówień biletów, np. na filmy czy wydarzenia sportowe.

Zapis JSON
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Pola
ticketEvent

object (TicketEvent)

Wydarzenie zostało zastosowane do wszystkich biletów elementu zamówienia.

TicketEvent

Reprezentuje jedno zdarzenie.

Zapis JSON
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Pola
type

enum (Type)

Wymagany: typ biletu na wydarzenie, np. film, koncert.

name

string

Wymagana: nazwa wydarzenia. Jeśli na przykład wydarzenie jest film, powinna to być jego nazwa.

description

string

Opis wydarzenia.

url

string

URL do informacji o wydarzeniu.

location

object (Location)

Lokalizacja organizacji lub miejsce, w którym odbywa się wydarzenie.

eventCharacters[]

object (EventCharacter)

Znaki związane z tym zdarzeniem. Mogą to być reżyserzy, aktorzy wydarzeń filmowych, wykonawcy koncertu itp.

startDate

object (Time)

Godzina rozpoczęcia

endDate

object (Time)

Godzina zakończenia

doorTime

object (Time)

Godzina wpisu, która może się różnić od godziny rozpoczęcia wydarzenia. np. wydarzenie zaczyna się o 9:00, a wejście to 8:30.

Typ

Typ zdarzenia.

Wartości w polu enum
EVENT_TYPE_UNKNOWN Nieznany typ zdarzenia.
MOVIE Film.
CONCERT Koncert.
SPORTS Sport.

EventCharacter

Jeden znak zdarzenia, np. organizator, wykonawca itp.

Zapis JSON
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
Pola
type

enum (Type)

Rodzaj znaku zdarzenia, np. aktora czy reżysera.

name

string

Imię postaci.

image

object (Image)

Obrazy postaci.

Typ

Typ postaci.

Wartości w polu enum
TYPE_UNKNOWN Nieznany typ.
ACTOR Użytkownik, który wykonał czynność.
PERFORMER Wykonawca.
DIRECTOR Reżysera
ORGANIZER Organizatorze.