Method: notification.partners.orders.patch
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คำขอ HTTP
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{order.name=partners/*/orders/*}
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ |
order.name |
string
ชื่อแหล่งข้อมูลของคำสั่งซื้อ: partners/{partner ID}/orders/{order ID}
|
พารามิเตอร์การค้นหา
| พารามิเตอร์ |
updateMask |
string (FieldMask format)
ฟิลด์มาสก์ของช่องคำสั่งซื้อทั้งหมดที่จะอัปเดต ซึ่งเป็นรายการชื่อฟิลด์ที่สมบูรณ์ในตัวเองที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
|
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ Order
เนื้อหาการตอบกลับ
คำสั่งซื้อสำหรับการนัดหมายเพื่อรับบริการกับผู้ขาย
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| ช่อง |
name |
string
ชื่อทรัพยากรของคำสั่งซื้อ: partners/{partner ID}/orders/{order ID}
|
clientInformation |
object (ClientInformation)
ข้อมูลส่วนบุคคลของลูกค้าที่สั่งซื้อ
|
paymentInformation |
object (PaymentInformation)
ข้อมูลเกี่ยวกับธุรกรรมการชำระเงินที่เกี่ยวข้องกับคำสั่งซื้อ
|
merchantId |
string
รหัสของผู้ขายที่ให้บริการทั้งหมดในคำสั่งซื้อนี้
|
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
รหัสของบริการของผู้ขาย
|
startSec |
string (int64 format)
เวลาเริ่มต้นของช่วงเวลาที่สะดวกสำหรับนัดหมายในหน่วยวินาทีของเวลา UTC นับตั้งแต่ Unix Epoch
|
durationSec |
string (int64 format)
ระยะเวลาของช่วงการนัดหมายเป็นวินาที
|
tickets[] |
object (OrderedTickets)
จำนวนตั๋วที่สั่งซื้อตามประเภทตั๋ว
|
price |
object (Price)
ราคารวม (ไม่รวมภาษี) ของรายการโฆษณานี้
|
status |
enum (BookingStatus)
สถานะของรายการโฆษณา
|
OrderedTickets
จำนวนตั๋วที่สั่งซื้อตามประเภทตั๋ว
| การแสดง JSON |
{
"ticketId": string,
"count": integer
} |
| ช่อง |
ticketId |
string
รหัสของประเภทคำขอแจ้งปัญหา
|
count |
integer
จำนวนตั๋วที่สั่งซื้อสำหรับประเภทนี้
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-24 UTC
[null,null,["อัปเดตล่าสุด 2025-07-24 UTC"],[[["\u003cp\u003eUpdates an existing Order using an HTTP PATCH request to a specific resource URL.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003eorder.name\u003c/code\u003e as a path parameter and optionally \u003ccode\u003eupdateMask\u003c/code\u003e as a query parameter for specifying fields to update.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an \u003ccode\u003eOrder\u003c/code\u003e object with details like client information, payment information, merchant ID, and line items.\u003c/p\u003e\n"],["\u003cp\u003eThe response body, on success, includes an updated \u003ccode\u003eOrder\u003c/code\u003e object with the same structure as the request body.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/mapsbooking\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: notification.partners.orders.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Order.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [LineItem](#LineItem)\n - [JSON representation](#LineItem.SCHEMA_REPRESENTATION)\n- [OrderedTickets](#OrderedTickets)\n - [JSON representation](#OrderedTickets.SCHEMA_REPRESENTATION)\n\nUpdates an existing [Order](/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.orders/patch#body.Order).\n\n### HTTP request\n\n`PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{order.name=partners/*/orders/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------------|\n| `order.``name` | `string` Resource name of the order: `partners/{partner ID}/orders/{order ID}` |\n\n### Query parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `update``Mask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Field mask of all order fields to be updated This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [Order](/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.orders/patch#body.Order).\n\n### Response body\n\nAn order for service appointments with a merchant.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"clientInformation\": { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.bookings#ClientInformation) }, \"paymentInformation\": { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.bookings#PaymentInformation) }, \"merchantId\": string, \"item\": [ { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.orders/patch#LineItem) } ] } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of the order: `partners/{partner ID}/orders/{order ID}` |\n| `client``Information` | `object (`[ClientInformation](/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.bookings#ClientInformation)`)` Personal information of the client making the order. |\n| `payment``Information` | `object (`[PaymentInformation](/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.bookings#PaymentInformation)`)` Information about payment transactions that relate to the order. |\n| `merchant``Id` | `string` ID of the merchant that all services in this order belong to. |\n| `item[]` | `object (`[LineItem](/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.orders/patch#LineItem)`)` Line items in this order. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/mapsbooking`\n\nLineItem\n--------\n\nA single item in an order--the booking of a single service in a single time slot.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"serviceId\": string, \"startSec\": string, \"durationSec\": string, \"tickets\": [ { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.orders/patch#OrderedTickets) } ], \"price\": { object (/maps-booking/reference/maps-booking-api/rest/v1alpha/Price) }, \"status\": enum (/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.bookings#BookingStatus) } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `service``Id` | `string` ID of the merchant Service. |\n| `start``Sec` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Start time of the appointment slot in seconds of UTC time since Unix epoch. |\n| `duration``Sec` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Duration of the appointment slot in seconds. |\n| `tickets[]` | `object (`[OrderedTickets](/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.orders/patch#OrderedTickets)`)` Number of tickets ordered by Ticket Type. |\n| `price` | `object (`[Price](/maps-booking/reference/maps-booking-api/rest/v1alpha/Price)`)` The total price (excluding taxes) of this Line Item. |\n| `status` | `enum (`[BookingStatus](/maps-booking/reference/maps-booking-api/rest/v1alpha/notification.partners.bookings#BookingStatus)`)` Status of the Line Item. |\n\nOrderedTickets\n--------------\n\nNumber of ordered tickets by Ticket Type.\n\n| JSON representation |\n|--------------------------------------------------|\n| ``` { \"ticketId\": string, \"count\": integer } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------|\n| `ticket``Id` | `string` ID of a Ticket Type. |\n| `count` | `integer` Number of tickets ordered for this type. |"]]
