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)

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

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.

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. To pole zostanie zapełnione przez działania w Google, jeśli proces płatności jest zarządzana 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
}
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

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.

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": integer
}
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

integer

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

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.

EventCharacter

Jeden znak zdarzenia, np. organizator, wykonawca itp.

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

enum (Type)

typ znaku zdarzenia, np. aktora czy reżysera.
name

string

nazwy postaci.
image

object (Image)

Obrazy postaci.