Order

Jednostka zamówienia. Uwaga: 1. Jeśli nie określono inaczej, żaden ciąg znaków na każdym poziomie musi 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 są określone) 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ć niepowtarzalny i jest wymagany przy kolejnych aktualizacjach zamówień. Ten identyfikator może być ustawiony na podany identyfikator googleOrderId lub inną unikalną wartość. Pamiętaj, że identyfikator prezentowany 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 dla użytkownika odnoszący się do bieżącego zamówienia. Ten identyfikator powinien być taki sam jak identyfikator wyświetlany w przypadku tego zamówienia w innych kontekstach, w tym w witrynach, aplikacjach i poczcie e-mail.

userVisibleStateLabel
(deprecated)

string

Wycofano: zamiast tego użyj stanu rozszerzenia Orders. Etykieta widoczna dla użytkownika wskazująca stan 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. Wymagane w przypadku aktualizacji zamówienia.

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ę to różnić od wartości dostawcy na poziomie elementu zamówienia. Przykład: zamówienie z Expedii z elementem zamówienia z firmy ANA.

contents

object (Contents)

Wymagane: zawartość zamówienia, która stanowi grupę elementów zamówienia.

priceAttributes[]

object (PriceAttribute)

Cena, rabaty, podatki itd.

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 odnoszących się do 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)

Ujawnianie informacji związane z tym zamówieniem.

vertical
(deprecated)

object

Wycofane: używaj branż. Właściwości te będą stosowane do wszystkich elementów zamówienia, chyba że w którymś z nich zostaną zastąpione. Ta kategoria musi być zgodna z branżą 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ą stosowane do wszystkich elementów zamówienia, chyba że w którymś z nich zostaną zastąpione. Ta kategoria musi być zgodna z branżą na poziomie elementu zamówienia. verticals może mieć tylko jedną z tych wartości:
purchase

object (PurchaseOrderExtension)

Zamówienie

ticket

object (TicketOrderExtension)

Zamawianie 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 telefonów użytkownika.

PhoneNumber

Standardowa reprezentacja numeru telefonu.

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

string

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

extension

string

W rekomendacjach ITU rozszerzenie nie jest ustandaryzowane, chyba że jest zdefiniowane jako ciąg liczb o maksymalnej długości 40 cyfr. Jest to ciąg znaków, który umożliwia użycie w rozszerzeniu na początku zera (organizacje mają do tego pełną swobodę, ponieważ nie ma określonego standardu). Oprócz cyfr mogą być tu też zapisane inne znaki wybierania, takie jak „,” (sygnalizujące oczekiwanie). Na przykład w formacie xxx-xxx-xxxx wew. 123 „123” to rozszerzenie.

preferredDomesticCarrierCode

string

Kod wyboru operatora, który jest preferowany, gdy dzwonisz na ten numer w danym kraju. Dotyczy to także kodów, które należy wybrać w niektórych krajach, gdy dzwonisz z telefonu stacjonarnego na telefon komórkowy lub odwrotnie. Na przykład w Kolumbii trzeba wybrać „3” przed samym numerem telefonu w przypadku połączenia z telefonu komórkowego na krajowy telefon stacjonarny i odwrotnie. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Jest to „preferowany” kod, 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). np. https://www.agentx.com/logo.png. To pole jest wymagane.

accessibilityText

string

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

height

number

Wysokość obrazu w pikselach. Opcjonalnie.

width

number

Szerokość obrazu w pikselach. Opcjonalnie.

Sprzedawca

Sprzedawca koszyka, zamówienia lub 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. „Chleb Panra”.

image

object (Image)

Zdjęcie powiązane ze sprzedawcą.

phoneNumbers[]

object (PhoneNumber)

Numery telefonów sprzedawców.

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 uprawnienia [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

formattedAddress

string

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

zipCode

string

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

city

string

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

postalAddress

object (PostalAddress)

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

name

string

Nazwa miejsca.

phoneNumber

string

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

notes

string

Uwagi na temat lokalizacji.

placeId

string

Element PlaceId jest używany z interfejsem Places API do pobierania szczegółów miejsca. Więcej informacji znajdziesz na stronie 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ójnych wartości reprezentujących stopnie szerokości i długości geograficznej w stopniach. O ile nie wskazano inaczej, urządzenie musi być zgodne 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 [-180,0; +180,0].

PostalAddress

Reprezentuje adres pocztowy, na przykład adres dostawy lub płatności. Podany adres pocztowy pozwala na dostarczenie przesyłek do lokalu, skrytki pocztowej itp. Nie służy do modelowania lokalizacji geograficznych (dróg, miast, gór).

W typowym użyciu adres jest tworzony na podstawie danych wejściowych użytkownika lub importu istniejących danych, w zależności od typu procesu.

Wskazówki dotyczące wpisywania / edytowania adresu: – Używaj widżetu adresu gotowego na korzystanie z i18n, np. https://github.com/google/libaddressinput). – Użytkownicy nie powinni widzieć elementów interfejsu do wprowadzania lub edytowania pól poza krajami, w których to pole jest używane.

Więcej wskazówek dotyczących korzystania z tego schematu znajdziesz na 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 elementu PostalAddress. Musi być ustawiona wartość 0, czyli najnowsza wersja.

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

regionCode

string

To pole jest wymagane. Kod regionu CLDR kraju lub regionu adresu. Nigdy nie jest to wywnioskowane i to użytkownik decyduje o tym, czy wartość jest poprawna. Szczegółowe informacje znajdziesz na stronach http://cldr.unicode.org/ i http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: „CH” w przypadku Szwajcarii.

languageCode

string

Opcjonalnie. Kod języka BCP-47 treści tego adresu (jeśli jest znany). Jest to często język interfejsu formularza do wprowadzania danych lub powinien odpowiadać jednemu z języków używanych w kraju/regionie adresu lub ich transliteracji. Może to wpływać na formatowanie w niektórych krajach, ale nie jest niezbędne dla poprawności danych oraz nie ma wpływu na weryfikację ani inne operacje związane z formatowaniem.

Jeśli ta wartość jest nieznana, pomiń ją (zamiast określać potencjalnie nieprawidłową wartość domyślną).

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

postalCode

string

Opcjonalnie. Kod pocztowy adresu. Nie we wszystkich krajach stosuje się kod pocztowy lub go nie wymaga, ale tam, gdzie są one używane, mogą wymagać dodatkowej weryfikacji w innych częściach adresu (np. w Stanach Zjednoczonych).

sortingCode

string

Opcjonalnie. Dodatkowy kod rozliczeniowy zależny od kraju. Ta funkcja nie jest używana w większości regionów. Ta wartość jest ciągiem znaków typu „CEDEX”, opcjonalnie po którym następuje liczba (np. „CEDEX 7”), lub sama liczba reprezentująca „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (malawi) lub „wskaźnik poczty” (np. Wybrzeże Kości Słoniowej).

administrativeArea

string

Opcjonalnie. Najwyższy podział administracyjny używany w przypadku adresów pocztowych w kraju lub regionie. Może to być na przykład stan, prowincja, obwód lub prefektura. W przypadku Hiszpanii jest to prowincja, a nie społeczność autonomiczna (np. „Barcelona”, a nie „Katalonia”). W wielu krajach nie używa się obszaru administracyjnego w adresach pocztowych. Na przykład w Szwajcarii to pole powinno pozostać puste.

locality

string

Opcjonalnie. Zwykle odnosi się do miasta/miasta adresu. Przykłady: miasto w USA, gmina IT, brytyjska poczta. W regionach świata, gdzie miejscowości nie są dobrze zdefiniowane lub nie mieszczą się w tej strukturze, pozostaw pole rejonu puste i użyj pola addressLines.

sublocality

string

Opcjonalnie. Dzielnica adresu. Mogą to być dzielnice, dystrykty, dzielnice.

addressLines[]

string

Nieuporządkowane wiersze adresu opisujące niższe poziomy adresu.

Ponieważ wartości w wierszach addressLines nie mają informacji o typie i czasami mogą zawierać wiele wartości w jednym polu (np. „Austin, TX”), kolejność wierszy musi być jasna. Kolejność wierszy adresu powinna być określona jako „kolejność kopert” dla kraju lub regionu adresu. Tam, gdzie może się to różnić (np. w Japonii), używany jest atrybut „address_language”, aby był zrozumiały (np. „ja” to małe i duże uporządkowanie oraz „ja-Latn” lub „pl” w przypadku małych i dużych rozmiarów). Dzięki temu można wybrać najwęższy wiersz adresu na podstawie języka.

Minimalna dozwolona reprezentacja strukturalna adresu składa się z kodu regionCode, a wszystkie pozostałe informacje są umieszczone w wierszach adresu. Taki adres można sformatować mniej więcej bez użycia geokodowania, ale nie można myśleć semantycznie na temat żadnego elementu adresu, dopóki nie zostanie rozwiązany przynajmniej częściowo.

Utworzenie adresu zawierającego tylko kod regionu i pole adresowe, a następnie geokodowanie jest zalecanym sposobem obsługi całkowicie nieuporządkowanych adresów (zamiast zgadywania, które części adresu powinny być miejscowością lub obszarem administracyjnych).

recipients[]

string

Opcjonalnie. Odbiorca pod tym adresem. W pewnych okolicznościach to pole może zawierać informacje wielowierszowe. Na przykład może zawierać informacje związane z dbaniem o nie.

organization

string

Opcjonalnie. Nazwa organizacji pod adresem.

Spis treści

Kod elementu zamówienia.

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

object (LineItem)

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

LineItem

Jeden element zamówienia zawiera 1 branżę. Zamówienie lub koszyk może zawierać wiele elementów zamówienia tej samej branży. Podrzędne elementy zamówienia, dodatki itp. powinny być zdefiniowane w protosach pionowych w zależności od przypadków użycia. Uwaga: 1. Jeśli nie określono inaczej, żaden ciąg znaków na każdym poziomie musi 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 są określone) 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 elementu zamówienia widoczna na potwierdzeniu. Maksymalna dozwolona długość to 100 znaków.

userVisibleStateLabel
(deprecated)

string

Rola wycofana. Użyj stanu na poziomie branży. Na przykład w przypadku zakupów należy użyć parametru purchaseOrderExtension.status. Etykieta widoczna dla użytkownika wskazująca stan tego elementu zamówienia.

provider

object (Merchant)

Dostawca danego elementu zamówienia, jeśli jest inny niż cały zamówienie. 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)

Dalsze działania związane z elementem zamówienia.

recipients[]

object (UserInfo)

klientów na poziomie elementu zamówienia, może on być inny niż kupujący na poziomie zamówienia. Przykład: użytkownik X dokonał rezerwacji w restauracji pod nazwą 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 elementu zamówienia, np. zasady anulowania;

disclosures[]

object (Disclosure)

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

vertical
(deprecated)

object

Wycofane: używaj branż. Wymagane: semantyczne treści elementu zamówienia określone na podstawie jego typu lub branży. Każda branża powinna mieć własne szczegóły realizacji zamówienia. Musi mieć jedną 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: semantyczne treści elementu zamówienia określone na podstawie jego typu lub branży. Każda branża powinna mieć własne szczegóły realizacji zamówienia. verticals może mieć tylko jedną z tych wartości:
purchase

object (PurchaseItemExtension)

Zamówienia takie jak towary, jedzenie itp.

reservation

object (ReservationItemExtension)

Rezerwacje 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: typ atrybutu pieniężnego.

name

string

Wymagany: wyświetlany przez użytkownika ciąg atrybutu cena. Są one wysyłane i zlokalizowane przez sprzedawcę.

state

enum (State)

Wymagane: stan ceny: wartość szacunkowa a rzeczywista.

taxIncluded

boolean

Określa, czy cena zawiera podatek.

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

object (Money)

Kwota pieniężna.

amountMillipercentage
(deprecated)

number

Specyfikacja procentowa z dokładnością do 1/1000 procenta. Na przykład: 8,750% przedstawia się jako 8750, a ujemne wartości procentowe oznaczają rabaty procentowe. Wycofuję to pole. Rozważ dodanie tej funkcji ponownie, jeśli wymagane jest solidne zastosowanie.

Typ

Reprezentuje rodzaj pieniędzy.

Wartości w polu enum
TYPE_UNSPECIFIED Typ nie został określony. Klienci nie powinni go ustawiać bezpośrednio.
REGULAR Zwykła cena wyświetlana przed zastosowaniem rabatów itp.
DISCOUNT Do odjęcia od sumy częściowej.
TAX Zostanie dodana do sumy częściowej.
DELIVERY Zostanie dodana do sumy częściowej.
SUBTOTAL Suma częściowa przed dodaniem niektórych opłat.
FEE Wszelkie dodatkowe Opłaty.
GRATUITY Zostanie dodana do sumy częściowej.
TOTAL Wyświetlona cena zamówienia lub elementu zamówienia.

Stan

Reprezentuje stan ceny.

Wartości w polu enum
STATE_UNSPECIFIED Nie określono.
ESTIMATE Cena jest tylko przybliżona.
ACTUAL Rzeczywista cena, którą zostanie naliczona opłata za użytkownika.

Pieniądze

Reprezentuje kwotę pieniędzy wraz z typem 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. Na przykład w tym polu należy ustawić wartość 1990000 dla kwoty 1, 99 USD.

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)

Wymagane: 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)

Działanie do wykonania.

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 Zmień działanie związane z zamówieniem.
CANCEL Anulowanie zamówienia.
RETURN Działanie zwrotu zamówienia.
EXCHANGE Działanie dotyczące zamówienia na giełdzie.
EMAIL

Działanie związane z e-mailem. Typy „EMAIL” i „CALL” zostały wycofane. Parametr openUrlAction.url może być używany jako numer telefonu lub adres e-mail.

CALL

Wezwania do działania.

REORDER Czynność zmiany kolejności.
REVIEW Przejrzyj działanie związane z zamówieniem.
CUSTOMER_SERVICE Skontaktuj się z obsługą klienta.
FIX_ISSUE Aby rozwiązać problem, przekieruj go na 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óre może być dowolnym z tych elementów: – Adres URL http/https umożliwiający otwarcie aplikacji lub strony internetowej

androidApp

object (AndroidApp)

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

urlTypeHint

enum (UrlTypeHint)

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

AndroidApp

Specyfikacja ograniczeń dotyczących realizacji zamówień w aplikacji na Androida

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

string

Nazwa pakietu Nazwa pakietu musi być określona podczas definiowania funkcji Android Fulfillment.

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 uwzględnić filtr VersionFilter.

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

number

Minimalny kod wersji lub 0 włącznie.

maxVersion

number

Kod wersji maksymalnej (włącznie). Uwzględniany zakres to [minVersion:maxVersion]. Zakres null oznacza dowolną wersję. Przykłady: aby określić pojedynczą wersję, użyj wartości [target_version:target_version]. Aby podać dowolną wersję, pozostaw atrybuty minVersion i maxVersion nieokreślone. Aby określić wszystkie wersje do momentu parametru maxVersion, pozostaw nieokreśloną wartość minVersion. Aby określić wszystkie wersje od minVersion, pozostaw nieokreśloną wartość maxVersion.

UrlTypeHint

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

Wartości w polu enum
URL_TYPE_HINT_UNSPECIFIED Brak informacji
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 w elemencie <link rel="amphtml">.

ActionMetadata

Metadane powiązane z działaniem.

Zapis JSON
{
  "expireTime": string
}
Pola
expireTime

string (Timestamp format)

Godzina wygaśnięcia tego działania.

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

Ujawnienie

Informacje o produktach, usługach lub zasadach wyświetlane użytkownikowi.

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

string

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

disclosureText

object (DisclosureText)

Treść oświadczenia. Linki internetowe są dozwolone.

presentationOptions

object (DisclosurePresentationOptions)

Opcje prezentacji komunikatu.

DisclosureText

Reprezentuje zwykły tekst z linkami internetowymi.

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

string

Tekst do wyświetlenia, zawierający symbole zastępcze, takie jak „{0}” i „{1}”, dla każdego linku tekstowego, który należy wstawić. Przykład: „OSTRZEŻENIE: ten produkt może narażać Cię na działanie substancji chemicznych, o których wiemy, że Kalifornia może powodować raka. Aby uzyskać więcej informacji, przejdź do {0}." Tekst komunikatu nie może zawierać żadnych treści promocyjnych ani treści przypominających reklamy.

DisclosurePresentationOptions

Opcje prezentacji oświadczenia.

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

enum (PresentationRequirement)

Wymóg przedstawienia dokumentu informacyjnego.

initiallyExpanded

boolean

Określa, czy treść oświadczenia powinna zostać początkowo rozwinięta. Domyślnie jest on początkowo zwinięty.

PresentationRequirement

Wymóg przedstawienia oświadczenia.

Wartości w polu enum
REQUIREMENT_UNSPECIFIED Nieokreślone wymaganie. Nie należy tego wyraźnie ustawiać.
REQUIREMENT_OPTIONAL Informacja ta jest opcjonalna. Możesz ją pominąć, jeśli urządzenie nie obsługuje wyświetlania komunikatów.
REQUIREMENT_REQUIRED Ujawnienie informacji jest wymagane. Jeśli urządzenie nie obsługuje wyświetlania komunikatów, rozmowa będzie przekierowywana do telefonu.

PurchaseItemExtension

Zawartość elementu zamówienia z branży zakupów.

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)

Wymagane: stan na poziomie elementu zamówienia.

userVisibleStatusLabel

string

Wymagane: etykieta/ciąg znaków widoczna dla użytkownika. Maksymalna dozwolona długość to 50 znaków.

type

enum (PurchaseType)

Wymagane: typ zakupu.

productId
(deprecated)

string

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

quantity

number

Liczba sztuk produktu.

unitMeasure

object (MerchantUnitMeasure)

Miara jednostkowa. Określa rozmiar produktu w wybranych jednostkach. Rozmiar wraz z aktywną ceną służy do określania ceny jednostkowej.

returnsInfo

object (PurchaseReturnsInfo)

Zwraca informacje o tym elemencie zamówienia. Jeśli nie jest skonfigurowana, ten element zamówienia dziedziczy zwracane informacje 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

Wszelkie 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 Termin „IN_PREPARATION” może mieć inne znaczenie w różnych kontekstach. W przypadku zamówienia NA JEDZENIE może być to przygotowywane jedzenie. W przypadku handlu detalicznego może to być produkt w pakiecie.
CREATED Zamówienie zostało utworzone.
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, a 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 takie jak towary fizyczne.
FOOD Obejmuje to zakupy zamawiania jedzenia.
GROCERY Zakupy spożywcze
MOBILE_RECHARGE Zakup doładowania telefonu komórkowego.

MerchantUnitMeasure

Miara ceny jednostkowej przez sprzedawcę.

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

number

Wartość: przykład 1.2.

unit

enum (Unit)

Jednostka: przykład 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), zwrot jest dozwolony.

daysToReturn

number

Zwrot można dokonać w ciągu tylu dni.

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: typ realizacji zamówienia.

expectedFulfillmentTime

object (Time)

Przedział czasu, jeśli został określony zakres czasowy, lub szacowany czas dotarcia, jeśli określono jednorazowy. Oczekiwany czas dostawy lub odbioru.

expectedPreparationTime

object (Time)

Przedział czasu, jeśli został określony zakres czasowy, lub szacowany czas dotarcia, jeśli określono jednorazowy. Oczekiwany czas na przygotowanie jedzenia. Preferowana jednorazowo.

location

object (Location)

Miejsce odbioru lub dostawy.

expireTime

string (Timestamp format)

Godzina wygaśnięcia tej opcji realizacji zamówienia.

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 z użytkownikiem na potrzeby tej realizacji.

shippingMethodName

string

Nazwa metody dostawy wybranej przez użytkownika.

storeCode

string

Kod sklepu lokalizacji. Przykład: Walmart to sprzedawca, a sklepstoreCode to sklep, w którym zrealizowano zamówienie. 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 ODBIÓR.

Typ

Typ realizacji.

Wartości w polu enum
TYPE_UNSPECIFIED Typ nieokreślony.
DELIVERY To zamówienie zostanie dostarczone.
PICKUP To zamówienie musi zostać odebrane.

Godzina

Konstrukcja czasu do reprezentowania czasu zdarzenia używanego podczas wyświetlania zamówienia użytkownikowi.

Zapis JSON
{
  "timeIso8601": string
}
Pola
timeIso8601

string

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

PickupInfo

Szczegóły dotyczące odbioru zamówienia. Zawiera ona szczegóły, takie jak typ odbioru i dodatkowe metadane dołączone do każdego typu, jeśli takie istnieją.

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

enum (PickupType)

Metoda odbioru, na przykład INSTORE, CURBSIDE itp.

curbsideInfo

object (CurbsideInfo)

Szczegóły dotyczące na zewnątrz budynku. Jeśli wartość pickupType nie ma wartości „CURBSIDE”, to pole jest ignorowane.

checkInInfo[]

object (CheckInInfo)

Lista różnych metod meldowania się obsługiwanych przez partnera.

PickupType

Lista obsługiwanych typów odbioru.

Wartości w polu enum
UNSPECIFIED Nie określono typu odbioru.
INSTORE Odbierz jedzenie w restauracji.
CURBSIDE Zaparkuj pojazd w wyznaczonym miejscu przed restauracją, gdzie ktoś będzie mógł dostarczyć do niego jedzenie.

CurbsideInfo

Szczegóły dotyczące sposobu realizacji zamówienia na zewnątrz.

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

enum (CurbsideFulfillmentType)

Partnerzy potrzebują dodatkowych informacji, aby ułatwić realizację zamówień z odbiorem na zewnątrz. W zależności od wybranego typu realizacji zostaną zebrane odpowiednie informacje o użytkowniku.

userVehicle

object (Vehicle)

Szczegółowe informacje o pojeździe użytkownika, który składa zamówienie.

CurbsideFulfillmentType

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

Wartości w polu enum
UNSPECIFIED Nie określono typu realizacji na zewnątrz.
VEHICLE_DETAIL Aby ułatwić odbiór na zewnątrz, wymagane są szczegóły pojazdu.

Pojazd

Informacje o pojeździe

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

string

Marka pojazdu (np. „Honda”). Jest ona widoczna dla użytkownika i musi być zlokalizowana. To pole jest wymagane.

model

string

Model pojazdu (np. „Grom”). Jest ona widoczna dla użytkownika i musi być zlokalizowana. To pole jest wymagane.

licensePlate

string

Numer tablicy rejestracyjnej pojazdu (np. „1ABC234”). To pole jest wymagane.

colorName

string

Nazwa koloru pojazdu, np. czarny Opcjonalnie.

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żywana do wysyłania instrukcji dotyczących zameldowania.

CheckInType

Różne metody przesyłania instrukcji dotyczących zameldowania.

Wartości w polu enum
CHECK_IN_TYPE_UNSPECIFIED Nieznana wartość.
EMAIL Informacje o meldowaniu się 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, które są elementami, unikalny identyfikator elementu.

name

string

Nazwa opcji.

prices[]

object (PriceAttribute)

Łączna cena opcji.

note

string

Uwagi na temat opcji.

quantity

number

W przypadku opcji, które są elementami, liczba sztuk.

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 elementem zamówienia.

gtin

string

Globalny numer jednostki handlowej produktu. Ta opcja jest przydatna, jeśli w Merchant Center nie ma atrybutu offerId. Opcjonalnie.

plu

string

Kody wyszukiwania cen, powszechnie nazywane kodami PLU, numerami PLU, PLU, kody do produkcji lub etykiety, to system liczb, które jednoznacznie identyfikują produkty sprzedawane hurtowo w sklepach spożywczych i supermarketach.

productType

string

Kategoria produktu zdefiniowana przez sprzedawcę. Przykład: „Dom > Spożywcze > Nabiał i jajka > Mleko > Mleko pełnotłuste”

productAttributes

map (key: string, value: string)

Podane przez sprzedawcę informacje o produkcie, np. { "allergen": "peanut" }. Ta opcja jest przydatna, jeśli w Merchant Center nie ma atrybutu offerId. Opcjonalnie.

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

ReservationItemExtension

Zawartość elementu zamówienia dla zamówień z rezerwacją, takich jak restauracja, fryzjer 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)

Wymagane: stan rezerwacji.

userVisibleStatusLabel

string

Wymagane: etykieta/ciąg znaków widoczna dla użytkownika. Maksymalna dozwolona długość to 50 znaków.

type

enum (ReservationType)

Typ rezerwacji. Wartość może być nieskonfigurowana, jeśli nie ma zastosowania żadna z opcji typu.

reservationTime

object (Time)

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

userAcceptableTimeRange

object (Time)

Zakres czasowy akceptowalny dla użytkownika.

confirmationCode

string

Kod potwierdzenia rezerwacji.

partySize

number

Liczba osób.

staffFacilitators[]

object (StaffFacilitator)

Opiekunowie personelu, którzy będą obsługiwać rezerwację. Np. Fryzjer.

location

object (Location)

Lokalizacja usługi lub zdarzenia.

extension

object

Wszelkie 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 Nieokreślony stan.
PENDING Rezerwacja oczekuje.
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 dla fryzjera.

StaffFacilitator

Informacje o osobie obsługującej.

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

string

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

image

object (Image)

Obrazy 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 używany przez integratora do realizacji transakcji. Jeśli proces płatności jest zarządzany przez Actions-on-Google, to pole zostanie wypełnione przez Actions on Google.

paymentInfo

object (PaymentInfo)

Dane karty dotyczące zamówienia, które są przydatne podczas interakcji użytkownika.

PaymentResult

Wynik płatności używany przez integratora do realizacji 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. Podane są dane płatności Google lub forma płatności sprzedawcy. result może mieć tylko jedną z tych wartości:
googlePaymentData

string

Dane formy płatności podane przez Google. Jeśli firma obsługująca płatności znajduje się na liście firm obsługujących płatności obsługiwane przez Google: https://developers.google.com/pay/api/ otwórz link i przejdź do podmiotu przetwarzającego płatności, aby uzyskać więcej informacji. W przeciwnym razie zapoznaj się ze szczegółami ładunku poniżej. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

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

PaymentInfo

Dane karty dotyczące złożonego zamówienia. Ten protokół rejestruje informacje, które są przydatne podczas interakcji użytkownika.

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

object (PaymentMethodDisplayInfo)

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

paymentMethodProvenance

enum (PaymentMethodProvenance)

Pochodzenie formy płatności użytej do zrealizowania 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 realizacji 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. Przykład: VISA **** 1234 Sprawdzanie konta **** 5678

paymentMethodVoiceName

string

Nazwa formy płatności, która będzie wypowiadana użytkownikowi w przypadku urządzeń z Asystentem głosowym. Na przykład „wiza kończąca się na jeden dwa trzy cztery” lub „konto rozliczeniowe kończące się na pięć sześć siedemdziesiąt osiem”. Uwaga: jest to ciąg zoptymalizowany pod kątem głosu, który ma być używany zamiast parametru paymentMethodDisplayName w przypadku urządzeń obsługujących tylko asystenta głosowego. Jeśli ten ciąg znaków nie zostanie ustawiony, metoda parametru paymentMethodDisplayName będzie odczytywana użytkownikowi.

PaymentType

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

Wartości w polu enum
PAYMENT_TYPE_UNSPECIFIED Nieokreślony typ 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 Płatność gotówką.
GIFT_CARD Formą płatności jest karta podarunkowa.
WALLET Portfel zewnętrzny, np. PayPal

PaymentMethodProvenance

Reprezentuje pochodzenie formy płatności użytej w transakcji.

Wartości w polu enum
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED Pochodzenie nieokreślone.
PAYMENT_METHOD_PROVENANCE_GOOGLE Pochodzenie Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT Pochodzenie to Sprzedawca.

Promocja

Promocje/oferty dodane do koszyka.

Zapis JSON
{
  "coupon": string
}
Pola
coupon

string

Wymagane: kod kuponu zastosowanego do tej oferty.

PurchaseOrderExtension

Rozszerzenie zamówienia dla branży zakupów. Te właściwości mają zastosowanie do wszystkich elementów zamówienia w zamówieniu, 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

Etykieta/ciąg znaków stanu widoczna dla użytkownika. Maksymalna dozwolona długość to 50 znaków.

type

enum (PurchaseType)

Wymagane: typ zakupu.

returnsInfo

object (PurchaseReturnsInfo)

Informacje o zwrotach zamówienia.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Informacje o realizacji zamówienia.

extension

object

Wszelkie 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)

Lokalizacja zakupu (w sklepie stacjonarnym lub online)

errors[]

object (PurchaseError)

Opcjonalnie: błędy, które spowodowały odrzucenie tego zamówienia.

PurchaseLocationType

Typ lokalizacji zakupu.

Wartości w polu enum
UNSPECIFIED_LOCATION Nieznana wartość.
ONLINE_PURCHASE Wszystkie zakupy zostały kupione online.
INSTORE_PURCHASE Wszystkie zakupy w sklepach.

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: pokazuje szczegółowy powód odrzucenia zamówienia przez sprzedawcę.

description

string

Dodatkowy opis błędu.

entityId

string

Identyfikator jednostki odpowiadający błądowi. Na przykład może to być powiązane z identyfikatorem elementu LineItemId lub ItemOptionId.

updatedPrice

object (PriceAttribute)

Ma zastosowanie w przypadku typu błędu PRICE_CHANGED / INCORRECT_PRICE.

availableQuantity

number

Dostępna obecnie ilość. Ma zastosowanie 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 Nieprawidłowe dane elementu. Możliwe wartości to Item, FulfillmentOption, Promotion. Identyfikator jednostki jest wymagany.
AVAILABILITY_CHANGED Produkt jest niedostępny lub niewystarczająca liczba produktów, aby zrealizować żądanie. Identyfikator jednostki jest wymagany.
PRICE_CHANGED Cena produktu różni się od ceny podanej w polu „Element”. Wymagane są identyfikator jednostki i zaktualizowana cena.
INCORRECT_PRICE Błędy dotyczące cen w sekcji Opłaty (łącznie). Wymagane są identyfikator jednostki i zaktualizowana cena.
REQUIREMENTS_NOT_MET Ograniczenia dotyczące akceptowania zamówienia, które nie zostały spełnione – minimalny rozmiar koszyka itd.
TOO_LATE Opcja FulfillmentOption wygasła.
NO_CAPACITY Brak dostępnej pojemności usługi.
INELIGIBLE Użytkownik nie może złożyć zamówienia (na czarnej liście).
OUT_OF_SERVICE_AREA Nie można dostarczyć pod wskazany adres z powodu zasad granicznych itp.
CLOSED Restauracja jest nieczynna w momencie zamawiania.
PROMO_NOT_APPLICABLE Ogólny kod błędu wykrywający wszystkie przypadki niezastosowania kodu promocyjnego w sytuacjach, gdy żaden z poniższych nie pasuje. Dodaj kod promocyjny jako identyfikator jednostki.
PROMO_NOT_RECOGNIZED Partner nie rozpoznał kodu kuponu. Dodaj kod promocyjny jako identyfikator jednostki.
PROMO_EXPIRED Nie udało się zastosować, ponieważ promocja wygasła. Dodaj kod promocyjny jako identyfikator jednostki.
PROMO_USER_INELIGIBLE Bieżący użytkownik nie kwalifikuje się do skorzystania z tego kuponu. Dodaj kod promocyjny jako identyfikator jednostki.
PROMO_ORDER_INELIGIBLE Bieżące zamówienie nie kwalifikuje się do otrzymania tego kuponu. Dodaj kod promocyjny jako identyfikator jednostki.
UNAVAILABLE_SLOT Przedział zamawiania z wyprzedzeniem jest niedostępny.
FAILED_PRECONDITION Ograniczenia dotyczące akceptowania zamówień, które 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 mógł skontaktować się ze sprzedawcą.

TicketOrderExtension

Zamawianie treści na potrzeby zamówień biletów, np. filmów, wydarzeń sportowych itp.

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

object (TicketEvent)

Zdarzenie zostało zastosowane do wszystkich biletów w elemencie zamówienia.

TicketEvent

Reprezentuje pojedyncze wydarzenie.

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 wydarzenia związanego z biletem, np. film, koncert.

name

string

Wymagane: nazwa zdarzenia. Jeśli wydarzeniem jest na przykład film, należy podać tytuł filmu.

description

string

Opis wydarzenia.

url

string

Adres URL informacji o zdarzeniu.

location

object (Location)

Lokalizacja organizacji lub lokalizacja, w której odbywa się wydarzenie.

eventCharacters[]

object (EventCharacter)

Postacie związane z tym wydarzeniem. Mogą to być kierownicy lub aktorzy wydarzenia filmowego albo wykonawcy koncertu itp.

startDate

object (Time)

Godzina rozpoczęcia

endDate

object (Time)

Godzina zakończenia

doorTime

object (Time)

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

Typ

Typ zdarzenia.

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

EventCharacter

Jedna postać wydarzenia, np. organizator, wykonawca itp.

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

enum (Type)

Typ postaci związanej ze zdarzeniem, np. aktor lub reżyser.

name

string

Nazwa postaci.

image

object (Image)

Obrazy postaci.

Typ

Typ znaku.

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