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)

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)

datę i godzinę 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

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 lineItem, a 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 używany przez integratora do realizacji transakcji. Jeśli proces płatności jest zarządzany przez Actions-on-Google, to pole będzie wypełniane przez działania w 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
}
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

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)

Wymagany: 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.

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

integer

Dostępna obecnie ilość. Ma zastosowanie w przypadku AVAILABILITY_CHANGED.

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.

EventCharacter

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

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

enum (Type)

typ postaci zdarzenia, np. aktor lub reżyser.
name

string

nazwa postaci.
image

object (Image)

Obrazy postaci.