As reservas síncronas são confirmadas ou recusadas. em tempo real.
As reservas assíncronas são confirmadas pelo comerciante ou diminuir mais tarde.
Uma reserva é especificada como síncrona ou assíncrona no o nível de disponibilidade. Isso também significa que para determinado comerciante e serviço, é possível ter horários síncronos e assíncronos.
Para determinar a implementação adequada, primeiro identifique qual categoria seu inventário se enquadra em:
- Como ativar somente reservas síncronas: Todos os comerciantes e serviços são confirmados instantaneamente.
- Como ativar agendamentos assíncronos: Alguns ou todos os comerciantes e serviços exigem o manual do comerciante confirmação.
Critérios de reserva assíncrona
- A modificação de um agendamento assíncrono na Central de ações não é suporte.
- Os comerciantes devem poder aceitar ou recusar a reserva pelo sistema on-line do parceiro (por exemplo, painel do host do restaurante). Chamar o comerciante em nome do usuário para determinar se ele aceita ou recusar uma reserva não é permitido.
- Não é possível propor um novo horário de reserva ao comerciante. A o pedido de reserva precisa ser aceito ou recusado no estado original.
Como ativar apenas reservas síncronas
A reserva síncrona é a implementação padrão. Consulte a documentação de integração completa de reservas para mais informações.
Como ativar a reserva assíncrona
Se alguns ou todos os comerciantes usarem um fluxo de reserva assíncrono, o as seguintes mudanças precisam ser feitas:
-
Modo de confirmação: todas as representações de horários disponíveis agora contêm um campo
confirmation_mode
que descreve como as reservas desses horários serão confirmados. Especifique oconfirmation_mode
de cada horário disponível no seguinte:- No feed de disponibilidade,
confirmation_mode
é especificado na nível de disponibilidade - Nos métodos da API Booking Server,
confirmation_mode
é especificado em o nível do slot - Nos métodos da API Real-Time Updates,
confirmation_mode
é especificado no nível de disponibilidade
- No feed de disponibilidade,
- Status da reserva: todas as representações de reservas contêm um
Campo
status
que representa o estado da reserva. Três Novos valores de status assíncronos foram introduzidos:PENDING_CONFIRMATION
,DECLINED_BY_MERCHANT
eFAILED
. Use esses novos valores de status quando processar criações, recusas e falhas de reservas assíncronas. - Atualizações de agendamento: todas as atualizações assíncronas do status das reservas devem ser informadas pela API Booking Notification bookings.patch.
O diagrama abaixo mostra como o modo de confirmação e o status da reserva são usados em uma típica interação de reserva assíncrona.
![Figura 1: fluxo de reserva assíncrono](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/enabling_async_1.png?authuser=9&hl=pt-br)
- Os feeds de disponibilidade foram atualizados para que cada horário disponível o modo de confirmação for especificado. É importante ter essas informações feed para que possamos explicar a natureza assíncrona da reserva para o usuário no início do fluxo.
- Quando
BatchAvailabilityLookup
ouCheckAvailability
é chamado, transmitimos o modo de confirmação e, de preferência, o mesmo modo de confirmação a ser retornados. Isso garante que a mensagem adequada seja mostrada ao usuário. - Quando
CreateBooking
é chamado, passamos o modo de confirmação para indicar o modo de confirmação previsto. Quando o processo de reserva assíncrona solicitação for enviada, ela será retornada com o statusPENDING_MERCHANT_CONFIRMATION
: - Quando o comerciante aceita ou recusa um pedido de agendamento, o status é atualizado em tempo real pela API Booking Notification bookings.patch. Para recusar automaticamente reservas que não são respondido em tempo hábil, use a mesma atualização .
Feeds de disponibilidade
No feed de disponibilidade, especifique se cada horário é síncrono ou
assíncrona. Para fazer isso, defina o novo confirmation_mode
.
.
// Mode by which bookings for an availability slot are confirmed. enum ConfirmationMode { // The confirmation mode was not specified. // Synchronous confirmation will be assumed. CONFIRMATION_MODE_UNSPECIFIED = 0; // Bookings for this availability will be confirmed synchronously. CONFIRMATION_MODE_SYNCHRONOUS = 1; // Bookings for this availability will be confirmed asynchronously. CONFIRMATION_MODE_ASYNCHRONOUS = 2; }
Embora o modo de confirmação seja considerado síncrono se nenhum modo for especificado, é altamente recomendável especificar um modo, uma vez que elimina qualquer confusão sobre omissões acidentais.
Assíncrona
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
Síncrono
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] }
Síncrono e assíncrono
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, { "merchant_id": "10002", "service_id": "1000", "spots_open": 4, "spots_total": 4, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 2 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
Servidor de reserva
BatchAvailabilityLookup ou CheckAvailability
Na
BatchAvailabilityLookupResponse
(BAL)
ou
CheckAvailabilityResponse
(CA), retorne o mesmo confirmation_mode
especificado no
feed de disponibilidade e transmitido pela
BatchAvailabilityLookupRequest
ou
CheckAvailabilityRequest
.
BAL assíncrona
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "available": true } ] }
BAL síncrona
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "available": true } ] }
CA assíncrono
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
CA síncrono
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
CreateBooking
Devolva o status correto da reserva usando o opções abaixo:
// Status of a booking. // // Updating booking status does not change the status of the associated payment. // Prepayment status updates should be done using the PrepaymentStatus enum. enum BookingStatus { // Not specified. BOOKING_STATUS_UNSPECIFIED = 0; // Booking has been confirmed CONFIRMED = 1; // Booking is awaiting confirmation by the merchant before it can transition // into CONFIRMED status. Only applicable to non-payments Dining or // Beauty verticals. PENDING_MERCHANT_CONFIRMATION = 2; // Booking has been canceled on behalf of the user. // The merchant can still trigger a manual refund. CANCELED = 3; // User did not show for the appointment NO_SHOW = 4; // User did not show for the appointment in violation of the cancellation // policy. NO_SHOW_PENALIZED = 5; // Booking could not be completed by the async backend due to a failure. FAILED = 6; // Booking was asynchronously declined by the merchant. Only applicable to // non-payments Dining or Beauty verticals. DECLINED_BY_MERCHANT = 7; }
No CreateBookingResponse
,
Retorna o confirmation_mode
atual para o horário agregado da reserva informado.
no CreateBookingRequest. Além disso, quando a reserva é assíncrona,
Defina a status
como PENDING_MERCHANT_CONFIRMATION
. Confira se
o confirmation_mode
representa o que o usuário e o Reservar com
O Google espera evitar confundir o usuário.
Assíncrona
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "PENDING_MERCHANT_CONFIRMATION" } }
Síncrono
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "CONFIRMED" } }
UpdateBooking
Na versão inicial do modo assíncrono, as modificações do usuário em um agendamento não têm suporte. Em vez disso, o usuário deve cancelar a reserva e criar uma um novo agendamento.
Atualizações em tempo real
Para atualizações de disponibilidades em tempo real, confirmation_mode
deve ser especificado. Isso se aplica aos seguintes métodos:
RTU de inventário (ReplaceServiceAvailability ou BatchReplaceServiceAvailability)
Usando
Método availability.replace
(lote)
ou
método services.availability.replace
,
definir confirmation_mode
como CONFIRMATION_MODE_ASYNCHRONOUS
no Availability
Assíncrona
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] } ] }
Síncrono
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
Síncrono e assíncrono
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, { "startTime": "2014-10-03T11:00:00.00Z", "duration": "5400s", "spotsOpen": "1", "spotsTotal": "1", "availabilityTag": "1000002", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
API Booking Notification
As atualizações assíncronas em um status de reserva precisam ser feitas por meio da guia Método bookings.patch da API Notification.
Ao atualizar o status, inclua o nome do campo status
no
updateMask
.
Status | Descrição |
---|---|
CONFIRMED | O comerciante confirmou a reserva. |
FAILED | O parceiro não pôde confirmar ou recusar a reserva junto ao comerciante. |
DECLINED_BY_MERCHANT | O comerciante recusou a reserva. |
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"DECLINED_BY_MERCHANT"}
Em caso de falha na reserva, defina o status como FAILED
e
especifique o booking_failure. Se o status for definido como qualquer outro, o
booking_failure
foi ignorado.
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status&booking_failure.cause="SLOT_UNAVAILABLE" Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"FAILED"}
Notificações por e-mail
Para agendamentos assíncronos, há cinco possíveis e-mails relacionados à status da reserva enviada aos usuários.
PENDING_MERCHANT_CONFIRMATION
CONFIRMED
DECLINED_BY_MERCHANT
FAILED
CANCELED