Method: notification.partners.orders.patch
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Yêu cầu HTTP
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{order.name=partners/*/orders/*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
order.name |
string
Tên tài nguyên của đơn đặt hàng: partners/{partner ID}/orders/{order ID}
|
Tham số truy vấn
Thông số |
updateMask |
string (FieldMask format)
Mặt nạ trường của tất cả các trường đơn đặt hàng cần cập nhật Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Order
.
Nội dung phản hồi
Đơn đặt hàng cho các cuộc hẹn dịch vụ với người bán.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Trường |
name |
string
Tên tài nguyên của đơn đặt hàng: partners/{partner ID}/orders/{order ID}
|
clientInformation |
object (ClientInformation )
Thông tin cá nhân của khách hàng đặt món.
|
paymentInformation |
object (PaymentInformation )
Thông tin về các giao dịch thanh toán liên quan đến đơn đặt hàng.
|
merchantId |
string
Mã của người bán chứa tất cả dịch vụ trong đơn đặt hàng này.
|
item[] |
object (LineItem )
Mục hàng trong đơn đặt hàng này.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/mapsbooking
LineItem
Một mục trong đơn đặt hàng – việc đặt một dịch vụ trong một khung giờ.
Biểu diễn dưới dạng JSON |
{
"serviceId": string,
"startSec": string,
"durationSec": string,
"tickets": [
{
object (OrderedTickets )
}
],
"price": {
object (Price )
},
"status": enum (BookingStatus )
} |
Trường |
serviceId |
string
Mã nhận dạng Dịch vụ của người bán.
|
startSec |
string (int64 format)
Thời gian bắt đầu của khung giờ nhận đặt hẹn tính bằng giây theo giờ UTC kể từ thời gian Unix.
|
durationSec |
string (int64 format)
Thời lượng của khung giờ nhận đặt hẹn tính bằng giây.
|
tickets[] |
object (OrderedTickets )
Số lượng vé được sắp xếp theo Loại vé.
|
price |
object (Price )
Tổng giá (không bao gồm thuế) của Mục hàng này.
|
status |
enum (BookingStatus )
Trạng thái của mục hàng.
|
OrderedTickets
Số lượng vé đã đặt theo Loại vé.
Biểu diễn dưới dạng JSON |
{
"ticketId": string,
"count": integer
} |
Trường |
ticketId |
string
Mã của một loại phiếu yêu cầu hỗ trợ.
|
count |
integer
Số lượng vé được đặt cho loại này.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-24 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]