Method: notification.partners.orders.patch

更新現有的 Order

HTTP 要求

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{order.name=partners/*/orders/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
order.name

string

訂單的資源名稱:partners/{partner ID}/orders/{order ID}

查詢參數

參數
updateMask

string (FieldMask format)

所有要更新的訂單欄位的欄位遮罩

此為以半形逗號分隔的完整欄位名稱清單。範例:"user.displayName,photo"

要求主體

要求主體包含 Order 的例項。

回應主體

如果成功,回應主體中會有結構如下的資料:

向商家預約服務的訂單。

JSON 表示法
{
  "name": string,
  "clientInformation": {
    object (ClientInformation)
  },
  "paymentInformation": {
    object (PaymentInformation)
  },
  "merchantId": string,
  "item": [
    {
      object (LineItem)
    }
  ]
}
欄位
name

string

訂單的資源名稱:partners/{partner ID}/orders/{order ID}

clientInformation

object (ClientInformation)

下訂單客戶的個人資訊。

paymentInformation

object (PaymentInformation)

與訂單相關的付款交易資訊。

merchantId

string

此訂單中所有服務所屬商家的 ID。

item[]

object (LineItem)

此訂單中的委刊項。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/mapsbooking

LineItem

訂單中的單一項目 (單一時段中單一服務的預訂)。

JSON 表示法
{
  "serviceId": string,
  "startSec": string,
  "durationSec": string,
  "tickets": [
    {
      object (OrderedTickets)
    }
  ],
  "price": {
    object (Price)
  },
  "status": enum (BookingStatus)
}
欄位
serviceId

string

商家服務的 ID。

startSec

string (int64 format)

預約時段的開始時間 (採用世界標準時間,自 Unix Epoch 紀元時間起算,以秒為單位)。

durationSec

string (int64 format)

預約時段的持續時間 (以秒為單位)。

tickets[]

object (OrderedTickets)

按票券類型訂購的票券數量。

price

object (Price)

這個委刊項的總價 (不含稅金)。

status

enum (BookingStatus)

委刊項狀態。

OrderedTickets

按票券類型列出訂購票券數量。

JSON 表示法
{
  "ticketId": string,
  "count": integer
}
欄位
ticketId

string

票券類型的 ID。

count

integer

這個類型的訂購票券數量。