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 tingkat harus kurang dari 50 jumlah kecuali jika ditentukan lain. 3. Semua stempel waktu di semua tingkat, 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 yang berbeda dan lebih mudah digunakan. Panjang maksimum yang diizinkan adalah 128 karakter.
userVisibleOrderId

string

ID yang ditampilkan kepada pengguna yang merujuk ke pesanan saat ini. ID ini harus konsisten dengan ID yang ditampilkan untuk pesanan ini dalam konteks lain, termasuk situs, aplikasi, dan email.
userVisibleStateLabel
(deprecated)

string

Tidak digunakan lagi: Gunakan status OrderExtensions sebagai gantinya. 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. Wajib 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 proses checkout. Penyedia ini mungkin berbeda dari penyedia tingkat item baris. Contoh: Pesanan Expedia dengan item baris dari ANA.
contents

object (Contents)

Wajib: Susunan konten yang merupakan kelompok item baris.
priceAttributes[]

object (PriceAttribute)

Harga, diskon, pajak, dan sebagainya.
followUpActions[]

object (Action)

Tindakan lanjutan di tingkat pesanan.
paymentData

object (PaymentData)

Data terkait pembayaran untuk pesanan.
termsOfServiceUrl

string

Link ke persyaratan layanan yang berlaku untuk pesanan/pesanan yang diusulkan.
note

string

Catatan dilampirkan pada 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 sebagai gantinya. Properti ini akan diterapkan ke semua item baris, kecuali diganti pada beberapa item baris. Vertical ini harus sesuai dengan jenis vertikal 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 diganti pada beberapa item baris. Vertical ini harus sesuai dengan jenis vertikal tingkat item baris. verticals hanya dapat berupa salah satu dari 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. Minimal 1 item baris wajib diisi dan maksimal 50 item baris yang diizinkan. Semua item baris harus berada di 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 dapat berupa salah satu dari 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. Jika tidak, lihat dokumentasi berikut untuk mengetahui detail payload. https://developers.google.com/pay/api/payment-data-cryptography
merchantPaymentMethodId

string

Metode pembayaran yang disediakan Penjual/Action yang dipilih pengguna.

PaymentInfo

Informasi pembayaran terkait pesanan yang dibuat. Proto ini menangkap 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 ke 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 vertical pembelian. Properti ini berlaku untuk semua item baris dalam pesanan, kecuali jika diganti di 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 maksimum yang diizinkan adalah 50 karakter.
type

enum (PurchaseType)

Wajib: jenis pembelian.
returnsInfo

object (PurchaseReturnsInfo)

Info pengembalian untuk pesanan.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

Info pemenuhan pesanan untuk pesanan.
extension

object

Semua kolom tambahan 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: Error yang menyebabkan pesanan ini ditolak.

PurchaseError

Error yang menyebabkan pesanan pembelian (PO) dapat ditolak.

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

enum (ErrorType)

Wajib: Ini menunjukkan alasan terperinci alasan pesanan ditolak oleh penjual.
description

string

Deskripsi error tambahan.
entityId

string

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

object (PriceAttribute)

Relevan jika jenis error PRICE_CHANGED / INCORRECT_PRICE.
availableQuantity

integer

Jumlah yang tersedia sekarang. Berlaku jika terjadi AVAILABILITY_CHANGED.

TicketOrderExtension

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

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

object (TicketEvent)

Acara diterapkan ke 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 terkait tiket, misalnya, film, konser.
name

string

Wajib: nama peristiwa. Misalnya, jika peristiwa adalah film, ini harus merupakan 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. Dapat berupa sutradara atau aktor acara film, atau pemain konser, dll.
startDate

object (Time)

Waktu mulai.
endDate

object (Time)

Waktu berakhir.
doorTime

object (Time)

Waktu masuk, yang mungkin berbeda dengan waktu mulai acara. mis. acara dimulai pukul 09.00, tapi waktu masuknya pukul 08.30 WIB.

EventCharacter

Satu karakter peristiwa, mis. penyelenggara, penampil, dll.

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

enum (Type)

jenis karakter peristiwa, mis. aktor atau sutradara.
name

string

dari karakter tersebut.
image

object (Image)

Gambar karakter.