Method: notification.partners.orders.patch
Stay organized with collections
Save and categorize content based on your preferences.
Updates an existing Order
.
HTTP request
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{order.name=partners/*/orders/*}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
order.name |
string
Resource name of the order: partners/{partner ID}/orders/{order ID}
|
Query parameters
Parameters |
updateMask |
string (FieldMask 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" .
|
Request body
The request body contains an instance of Order
.
Response body
An order for service appointments with a merchant.
If successful, the response body contains data with the following structure:
Fields |
name |
string
Resource name of the order: partners/{partner ID}/orders/{order ID}
|
clientInformation |
object (ClientInformation )
Personal information of the client making the order.
|
paymentInformation |
object (PaymentInformation )
Information about payment transactions that relate to the order.
|
merchantId |
string
ID of the merchant that all services in this order belong to.
|
item[] |
object (LineItem )
Line items in this order.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/mapsbooking
LineItem
A single item in an order--the booking of a single service in a single time slot.
JSON representation |
{
"serviceId": string,
"startSec": string,
"durationSec": string,
"tickets": [
{
object (OrderedTickets )
}
],
"price": {
object (Price )
},
"status": enum (BookingStatus )
} |
Fields |
serviceId |
string
ID of the merchant Service.
|
startSec |
string (int64 format)
Start time of the appointment slot in seconds of UTC time since Unix epoch.
|
durationSec |
string (int64 format)
Duration of the appointment slot in seconds.
|
tickets[] |
object (OrderedTickets )
Number of tickets ordered by Ticket Type.
|
price |
object (Price )
The total price (excluding taxes) of this Line Item.
|
status |
enum (BookingStatus )
Status of the Line Item.
|
OrderedTickets
Number of ordered tickets by Ticket Type.
JSON representation |
{
"ticketId": string,
"count": integer
} |
Fields |
ticketId |
string
ID of a Ticket Type.
|
count |
integer
Number of tickets ordered for this type.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-17 UTC.
[null,null,["Last updated 2024-10-17 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. |"]]