Perbarui Urutan dari 3p ke AOG. Menampilkan INVALID_ ARGUMENT jika ID pesanan kosong atau tidak sama dengan pesanan yang ada.
Permintaan HTTP
PATCH https://actions.googleapis.com/v3/orders/{orderUpdate.order.merchantOrderId}
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
orderUpdate.order.merchantOrderId |
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 64 karakter. |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON | |
---|---|
{ "header": { object ( |
Kolom | ||
---|---|---|
header |
Header untuk permintaan pesanan pembaruan. |
|
orderUpdate.type |
Tidak digunakan lagi: Sebagai gantinya, gunakan OrderUpdate.update_mask. Jika tipe = SNAPSHOT, OrderUpdate.order harus merupakan seluruh pesanan. Jika jenis = ORDER_STATUS, ini adalah perubahan status tingkat pesanan. Hanya order.last_update_time dan status vertikal ini diambil. Catatan: type.ORDER_STATUS hanya mendukung pembaruan status PurcahaseOrderExtension dan tidak ada rencana untuk memperpanjang dukungan ini. Sebagai gantinya, sebaiknya gunakan updateMask karena lebih generik, dapat diperluas, dan dapat digunakan untuk semua vertical. |
|
orderUpdate.order.googleOrderId |
ID pesanan yang ditetapkan Google. |
|
orderUpdate.order.userVisibleOrderId |
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. |
|
orderUpdate.order.userVisibleStateLabel |
Tidak digunakan lagi: Sebagai gantinya, gunakan status OrderExtensions. Label yang terlihat oleh pengguna untuk status pesanan ini. |
|
orderUpdate.order.buyerInfo |
Info tentang pembeli. |
|
orderUpdate.order.image |
Gambar yang terkait dengan pesanan. |
|
orderUpdate.order.createTime |
Wajib: Tanggal dan waktu pesanan dibuat. Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: |
|
orderUpdate.order.lastUpdateTime |
Tanggal dan waktu pesanan terakhir diperbarui. Diperlukan untuk OrderUpdate. Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: |
|
orderUpdate.order.transactionMerchant |
Penjual yang memfasilitasi checkout. Ini dapat berbeda dari penyedia tingkat item baris. Contoh: Pesanan Expedia dengan item baris dari ANA. |
|
orderUpdate.order.contents |
Wajib: Pesan konten yang merupakan kelompok item baris. |
|
orderUpdate.order.priceAttributes[] |
Harga, diskon, pajak, dan sebagainya. |
|
orderUpdate.order.followUpActions[] |
Tindak lanjuti tindakan di tingkat pesanan. |
|
orderUpdate.order.paymentData |
Data terkait pembayaran untuk pesanan. |
|
orderUpdate.order.termsOfServiceUrl |
Link ke persyaratan layanan yang berlaku untuk pesanan/pesanan yang diajukan. |
|
orderUpdate.order.note |
Catatan dilampirkan ke pesanan. |
|
orderUpdate.order.promotions[] |
Semua promosi yang terkait dengan pesanan ini. |
|
orderUpdate.order.disclosures[] |
Pengungkapan yang terkait dengan pesanan ini. |
|
orderUpdate.order.vertical |
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: Objek yang berisi kolom tipe arbitrer. Kolom tambahan |
|
orderUpdate.updateMask |
Catatan: Ada pertimbangan/rekomendasi berikut untuk kolom khusus berikut: 1. order.last_update_time akan selalu diperbarui sebagai bagian dari permintaan update. 2. order.create_time, order.google_order_id, dan order.merchant_order_id akan diabaikan jika disediakan sebagai bagian dari updateMask. Daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya valid. Contoh: |
|
orderUpdate.userNotification |
Jika ditentukan, menampilkan notifikasi kepada pengguna dengan judul dan teks yang ditentukan. Menentukan notifikasi adalah saran untuk memberi tahu dan tidak dijamin akan menghasilkan notifikasi. |
|
orderUpdate.reason |
Alasan perubahan/pembaruan. |
|
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: |
||
orderUpdate.order.purchase |
Pesanan pembelian (PO) |
|
orderUpdate.order.ticket |
Pesanan tiket |
Isi respons
Jika berhasil, isi respons akan berisi instance Order
.
OrderUpdate
Memperbarui pesanan.
Representasi JSON | |
---|---|
{ "type": enum ( |
Kolom | |
---|---|
type |
Tidak digunakan lagi: Sebagai gantinya, gunakan OrderUpdate.update_mask. Jika tipe = SNAPSHOT, OrderUpdate.order harus merupakan seluruh pesanan. Jika jenis = ORDER_STATUS, ini adalah perubahan status tingkat pesanan. Hanya order.last_update_time dan status vertikal ini diambil. Catatan: type.ORDER_STATUS hanya mendukung pembaruan status PurcahaseOrderExtension dan tidak ada rencana untuk memperpanjang dukungan ini. Sebagai gantinya, sebaiknya gunakan updateMask karena lebih generik, dapat diperluas, dan dapat digunakan untuk semua vertical. |
order |
|
updateMask |
Catatan: Ada pertimbangan/rekomendasi berikut untuk kolom khusus berikut: 1. order.last_update_time akan selalu diperbarui sebagai bagian dari permintaan update. 2. order.create_time, order.google_order_id, dan order.merchant_order_id akan diabaikan jika disediakan sebagai bagian dari updateMask. Daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya valid. Contoh: |
userNotification |
Jika ditentukan, menampilkan notifikasi kepada pengguna dengan judul dan teks yang ditentukan. Menentukan notifikasi adalah saran untuk memberi tahu dan tidak dijamin akan menghasilkan notifikasi. |
reason |
Alasan perubahan/pembaruan. |
Jenis
Tidak digunakan lagi: Sebagai gantinya, gunakan OrderUpdate.update_mask. Mengizinkan pembaruan pada pesanan.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Jenis tidak ditentukan, tidak boleh menetapkan ini secara eksplisit. |
ORDER_STATUS |
Hanya perbarui status pesanan. |
SNAPSHOT |
Perbarui snapshot pesanan. |
UserNotification
Notifikasi pengguna opsional yang akan ditampilkan sebagai bagian dari pembaruan Pesanan.
Representasi JSON | |
---|---|
{ "title": string, "text": string } |
Kolom | |
---|---|
title |
Judul untuk notifikasi pengguna. Panjang maksimal yang diizinkan adalah 30 karakter. |
text |
Isi notifikasi. Panjang maksimum yang diizinkan adalah 100 karakter. |