Method: notification.partners.orders.patch
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Entradas ordenadas
Actualiza un Order
existente.
Solicitud HTTP
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{order.name=partners/*/orders/*}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
order.name |
string
Nombre del recurso del pedido: partners/{partner ID}/orders/{order ID}
|
Parámetros de consulta
Parámetros |
updateMask |
string (FieldMask format)
Máscara de campo de todos los campos de pedido que se actualizarán Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo" .
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Order
.
Cuerpo de la respuesta
Es un pedido de citas del servicio que ofrece un comercio.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Campos |
name |
string
Nombre del recurso del pedido: partners/{partner ID}/orders/{order ID}
|
clientInformation |
object (ClientInformation )
Es la información personal del cliente que realiza el pedido.
|
paymentInformation |
object (PaymentInformation )
Es la información sobre las transacciones de pago relacionadas con el pedido.
|
merchantId |
string
Es el ID del comercio al que pertenecen todos los servicios de este pedido.
|
item[] |
object (LineItem )
Son las líneas de pedido de este pedido.
|
Alcances de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/mapsbooking
elemento de una sola línea
Un solo artículo en un pedido: la reserva de un solo servicio en un solo horario.
Representación JSON |
{
"serviceId": string,
"startSec": string,
"durationSec": string,
"tickets": [
{
object (OrderedTickets )
}
],
"price": {
object (Price )
},
"status": enum (BookingStatus )
} |
Campos |
serviceId |
string
Es el ID del servicio del comercio.
|
startSec |
string (int64 format)
Hora de inicio del horario disponible en segundos de la hora UTC desde el ciclo de entrenamiento de Unix.
|
durationSec |
string (int64 format)
Es la duración del horario disponible en segundos.
|
tickets[] |
object (OrderedTickets )
Cantidad de entradas ordenadas por tipo de entrada.
|
price |
object (Price )
Es el precio total (sin impuestos) de esta línea de pedido.
|
status |
enum (BookingStatus )
Estado de la línea de pedido.
|
Entradas ordenadas
Cantidad de entradas ordenadas por tipo de ticket.
Representación JSON |
{
"ticketId": string,
"count": integer
} |
Campos |
ticketId |
string
Es el ID de un tipo de ticket.
|
count |
integer
Cantidad de entradas solicitadas para este tipo.
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-24 (UTC)
[null,null,["Última actualización: 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. |"]]