Order

Entitas pesanan. Catatan: 1. Semua string di semua level harus kurang dari 1.000 karakter kecuali jika ditentukan lain. 2. Semua kolom berulang di semua level harus berjumlah kurang dari 50 kecuali jika ditentukan lain. 3. Semua stempel waktu di semua level, jika ditentukan, harus berupa stempel waktu yang valid.

Representasi 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.
}
Kolom
googleOrderId

string

ID pesanan yang ditetapkan Google.

merchantOrderId

string

Wajib: ID pesanan internal yang ditetapkan penjual. ID ini harus unik, dan diperlukan untuk operasi pembaruan pesanan berikutnya. ID ini dapat ditetapkan ke googleOrderId yang diberikan, atau nilai unik lainnya. Perhatikan bahwa ID yang ditampilkan kepada pengguna adalah userVisibleOrderId, yang mungkin merupakan nilai berbeda yang lebih mudah digunakan. Panjang maksimum yang diizinkan adalah 128 karakter.

userVisibleOrderId

string

ID yang dilihat pengguna yang merujuk ke pesanan saat ini. Id ini harus konsisten dengan id yang ditampilkan untuk urutan ini dalam konteks lain, termasuk situs web, aplikasi, dan email.

userVisibleStateLabel
(deprecated)

string

Tidak digunakan lagi: Sebagai gantinya, gunakan status OrderExtensions. Label yang terlihat oleh pengguna untuk status pesanan ini.

buyerInfo

object (UserInfo)

info tentang pembeli.

image

object (Image)

Gambar yang terkait dengan pesanan.

createTime

string (Timestamp format)

Wajib: tanggal dan waktu pesanan dibuat.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

tanggal dan waktu pesanan terakhir diperbarui. Diperlukan untuk OrderUpdate.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".

transactionMerchant

object (Merchant)

Penjual yang memfasilitasi checkout. Ini dapat berbeda dari penyedia tingkat item baris. Contoh: Pesanan Expedia dengan item baris dari ANA.

contents

object (Contents)

Wajib: Pesan konten yang merupakan kelompok item baris.

priceAttributes[]

object (PriceAttribute)

Harga, diskon, pajak, dan sebagainya.

followUpActions[]

object (Action)

Tindak lanjuti tindakan di tingkat pesanan.

paymentData

object (PaymentData)

Data terkait pembayaran untuk pesanan.

termsOfServiceUrl

string

Link ke persyaratan layanan yang berlaku untuk pesanan/pesanan yang diajukan.

note

string

Catatan dilampirkan ke pesanan.

promotions[]

object (Promotion)

Semua promosi yang terkait dengan pesanan ini.

disclosures[]

object (Disclosure)

Pengungkapan yang terkait dengan pesanan ini.

vertical
(deprecated)

object

Tidak digunakan lagi: Gunakan vertical. Properti ini akan diterapkan ke semua item baris, kecuali jika diganti di beberapa item baris. Vertical ini harus cocok dengan jenis vertical tingkat item baris. Nilai yang mungkin: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

Kolom union verticals. Properti ini akan diterapkan ke semua item baris, kecuali jika diganti di beberapa item baris. Vertical ini harus cocok dengan jenis vertical tingkat item baris. verticals hanya ada berupa salah satu diantara berikut:
purchase

object (PurchaseOrderExtension)

Pesanan pembelian (PO)

ticket

object (TicketOrderExtension)

Pesanan tiket

Daftar Isi

Wrapper untuk item baris.

Representasi JSON
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Kolom
lineItems[]

object (LineItem)

Daftar item baris pesanan. Setidaknya 1 lineItem diperlukan dan maksimum 50 baris yang diizinkan. Semua item baris harus berasal dari vertical yang sama.

PaymentData

Data pembayaran yang terkait dengan pesanan.

Representasi JSON
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Kolom
paymentResult

object (PaymentResult)

Hasil pembayaran yang digunakan oleh integrator untuk menyelesaikan transaksi. Kolom ini akan diisi oleh tindakan di Google jika pengalaman checkout dikelola oleh actions-on-Google.

paymentInfo

object (PaymentInfo)

Informasi pembayaran terkait pesanan yang berguna untuk interaksi yang ditampilkan kepada pengguna.

PaymentResult

Hasil pembayaran yang digunakan oleh integrator untuk menyelesaikan transaksi.

Representasi 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.
}
Kolom
Kolom union result. Data pembayaran Google atau metode pembayaran penjual disediakan. result hanya ada berupa salah satu diantara berikut:
googlePaymentData

string

Data metode pembayaran yang disediakan Google. Jika pemroses pembayaran Anda tercantum sebagai pemroses pembayaran yang didukung Google di sini: https://developers.google.com/pay/api/ Buka pemroses pembayaran Anda melalui link untuk mengetahui detail selengkapnya. Atau, lihat dokumentasi berikut untuk mengetahui detail payload. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Metode pembayaran yang disediakan Penjual/Tindakan yang dipilih pengguna.

PaymentInfo

Informasi pembayaran terkait pesanan yang dibuat. Proto ini mencatat informasi yang berguna untuk interaksi yang ditampilkan kepada pengguna.

Representasi JSON
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Kolom
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

Info tampilan metode pembayaran yang digunakan untuk transaksi.

paymentMethodProvenance

enum (PaymentMethodProvenance)

Asal metode pembayaran yang digunakan untuk transaksi. Pengguna mungkin telah mendaftarkan metode pembayaran yang sama di Google dan penjual.

PaymentMethodDisplayInfo

Hasil pembayaran yang digunakan oleh integrator untuk menyelesaikan transaksi.

Representasi JSON
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string
}
Kolom
paymentType

enum (PaymentType)

Jenis pembayaran.

paymentMethodDisplayName

string

Nama metode pembayaran yang terlihat oleh pengguna. Misalnya, VISA **** 1234 Memeriksa akun **** 5678

Promosi

Promosi/Penawaran yang ditambahkan ke keranjang.

Representasi JSON
{
  "coupon": string
}
Kolom
coupon

string

Wajib: Kode kupon yang diterapkan untuk penawaran ini.

PurchaseOrderExtension

Ekstensi pesanan untuk vertikal pembelian. Properti ini berlaku untuk semua item baris dalam pesanan, kecuali diganti dalam item baris.

Representasi 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)
    }
  ]
}
Kolom
status

enum (PurchaseStatus)

Wajib: Status Keseluruhan untuk pesanan.

userVisibleStatusLabel

string

Label/string yang terlihat oleh pengguna untuk status. Panjang maksimal yang diizinkan adalah 50 karakter.

type

enum (PurchaseType)

Wajib: jenis pembelian.

returnsInfo

object (PurchaseReturnsInfo)

Info pengembalian pesanan.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Info pemenuhan pesanan.

extension

object

Kolom tambahan apa pun yang dipertukarkan antara penjual dan Google.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

purchaseLocationType

enum (PurchaseLocationType)

Lokasi pembelian (di toko / online)

errors[]

object (PurchaseError)

Opsional: Terjadi error karena pesanan ini ditolak.

PurchaseError

Error yang dapat menyebabkan pesanan pembelian ditolak.

Representasi JSON
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
Kolom
type

enum (ErrorType)

Wajib: Hal ini menunjukkan alasan terperinci pesanan ditolak oleh penjual.

description

string

Deskripsi error tambahan.

entityId

string

ID entitas yang sesuai dengan error. Contoh ini dapat sesuai dengan LineItemId / ItemOptionId.

updatedPrice

object (PriceAttribute)

Relevan dengan kasus jenis kesalahan PRICE_CHANGE / INCORRECT_PRICE.

availableQuantity

integer

Jumlah yang tersedia sekarang. Berlaku jika AVAILABILITY_ABILITY.

TicketOrderExtension

Memesan konten untuk pesanan tiket seperti film, olahraga, dll.

Representasi JSON
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Kolom
ticketEvent

object (TicketEvent)

Peristiwa ini berlaku untuk semua tiket item baris.

TicketEvent

Mewakili satu peristiwa.

Representasi 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)
  }
}
Kolom
type

enum (Type)

Wajib: jenis acara tiket, misalnya film, konser.

name

string

Wajib: nama peristiwa. Misalnya, jika acaranya adalah film, ini harus berupa nama film.

description

string

deskripsi peristiwa.

url

string

URL ke info peristiwa.

location

object (Location)

Lokasi tempat acara berlangsung, atau organisasi berada.

eventCharacters[]

object (EventCharacter)

Karakter yang terkait dengan peristiwa ini. Bisa jadi sutradara atau aktor acara film, atau artis konser, dll.

startDate

object (Time)

Waktu mulai.

endDate

object (Time)

Waktu berakhir.

doorTime

object (Time)

Waktu masuk, yang mungkin berbeda dengan waktu mulai acara, misalnya acara dimulai pukul 09.00, tetapi waktu masuknya adalah pukul 08.30.

EventCharacter

Satu karakter acara, misalnya penyelenggara, pengisi acara, dll.

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

enum (Type)

jenis karakter acara, mis. aktor atau sutradara.

name

string

nama dari karakter tersebut.

image

object (Image)

Gambar karakter.