Method: orders.patch

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

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 64 karakter.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "header": {
    object (OrderRequestHeader)
  },
  "orderUpdate": {
    "type": enum (Type),
    "order": {
      "googleOrderId": 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.
    },
    "updateMask": string,
    "userNotification": {
      object (UserNotification)
    },
    "reason": string
  }
}
Kolom
header

object (OrderRequestHeader)

Header untuk permintaan pesanan pembaruan.

orderUpdate.type
(deprecated)

enum (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

string

ID pesanan yang ditetapkan Google.

orderUpdate.order.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.

orderUpdate.order.userVisibleStateLabel
(deprecated)

string

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

orderUpdate.order.buyerInfo

object (UserInfo)

Info tentang pembeli.

orderUpdate.order.image

object (Image)

Gambar yang terkait dengan pesanan.

orderUpdate.order.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".
orderUpdate.order.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".
orderUpdate.order.transactionMerchant

object (Merchant)

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

orderUpdate.order.contents

object (Contents)

Wajib: Pesan konten yang merupakan kelompok item baris.

orderUpdate.order.priceAttributes[]

object (PriceAttribute)

Harga, diskon, pajak, dan sebagainya.

orderUpdate.order.followUpActions[]

object (Action)

Tindak lanjuti tindakan di tingkat pesanan.

orderUpdate.order.paymentData

object (PaymentData)

Data terkait pembayaran untuk pesanan.

orderUpdate.order.termsOfServiceUrl

string

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

orderUpdate.order.note

string

Catatan dilampirkan ke pesanan.

orderUpdate.order.promotions[]

object (Promotion)

Semua promosi yang terkait dengan pesanan ini.

orderUpdate.order.disclosures[]

object (Disclosure)

Pengungkapan yang terkait dengan pesanan ini.

orderUpdate.order.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" }.
orderUpdate.updateMask

string (FieldMask format)

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: "user.displayName,photo".
orderUpdate.userNotification

object (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

string

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

object (PurchaseOrderExtension)

Pesanan pembelian (PO)

orderUpdate.order.ticket

object (TicketOrderExtension)

Pesanan tiket

Isi respons

Jika berhasil, isi respons akan berisi instance Order.

OrderUpdate

Memperbarui pesanan.

Representasi JSON 
{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}
Kolom
type
(deprecated)

enum (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

object (Order)
updateMask

string (FieldMask format)

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: "user.displayName,photo".
userNotification

object (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

string

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

string

Judul untuk notifikasi pengguna. Panjang maksimal yang diizinkan adalah 30 karakter.

text

string

Isi notifikasi. Panjang maksimum yang diizinkan adalah 100 karakter.