Method: notification.partners.orders.patch
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک Order
موجود را به روز می کند.
درخواست HTTP
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{order.name=partners/*/orders/*}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
order. name | string نام منبع سفارش: partners/{partner ID}/orders/{order ID} |
پارامترهای پرس و جو
پارامترها |
---|
update Mask | string ( FieldMask format) ماسک فیلد تمام فیلدهای سفارش به روز می شود این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" . |
درخواست بدن
بدنه درخواست حاوی نمونه ای از Order
است.
بدن پاسخگو
سفارش قرار ملاقات با یک تاجر.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
name | string نام منبع سفارش: partners/{partner ID}/orders/{order ID} |
client Information | object ( ClientInformation ) اطلاعات شخصی مشتری سفارش دهنده |
payment Information | object ( PaymentInformation ) اطلاعات مربوط به تراکنش های پرداخت مربوط به سفارش. |
merchant Id | string شناسه بازرگانی که تمام خدمات این سفارش متعلق به آن است. |
item[] | object ( LineItem ) موارد خط به این ترتیب. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/mapsbooking
آیتم خط
یک مورد در یک سفارش - رزرو یک سرویس در یک بازه زمانی واحد.
نمایندگی JSON |
---|
{
"serviceId": string,
"startSec": string,
"durationSec": string,
"tickets": [
{
object (OrderedTickets )
}
],
"price": {
object (Price )
},
"status": enum (BookingStatus )
} |
فیلدها |
---|
service Id | string شناسه خدمات بازرگان. |
start Sec | string ( int64 format) زمان شروع شکاف قرار بر حسب ثانیه از زمان UTC از زمان یونیکس. |
duration Sec | string ( int64 format) مدت زمان قرار ملاقات بر حسب ثانیه. |
tickets[] | object ( OrderedTickets ) تعداد بلیط های سفارش داده شده بر اساس نوع بلیط. |
price | object ( Price ) قیمت کل (بدون احتساب مالیات) این خط. |
status | enum ( BookingStatus ) وضعیت مورد خط. |
بلیط های سفارش داده شده
تعداد بلیط های سفارش داده شده بر اساس نوع بلیط.
نمایندگی JSON |
---|
{
"ticketId": string,
"count": integer
} |
فیلدها |
---|
ticket Id | string شناسه یک نوع بلیط |
count | integer تعداد بلیط های سفارش داده شده برای این نوع |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-28 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-28 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]