Method: notification.partners.bookings.patch

Atualiza um Booking existente.

Solicitação HTTP

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
booking.name

string

Nome do recurso da reserva: partners/{partner ID}/bookings/{booking ID}

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Máscara de campo de todos os campos de reserva a serem atualizados.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
bookingFailure

object (BookingFailure)

Se o processamento de uma solicitação de reserva confirmada de forma assíncrona falhar e o status da reserva for atualizado para FAILED, este campo precisará refletir o erro de lógica de negócios (por exemplo, o usuário tem uma reserva muito próxima). Este campo só deverá ser usado quando o status da reserva mudar para FAILED. Caso contrário, ele será ignorado.

Corpo da solicitação

O corpo da solicitação contém uma instância de Booking.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Booking.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/mapsbooking

BookingFailure

Dados de status que indicam a causa da falha assíncrona do processamento de uma reserva. O objetivo de BookingFailure é mostrar os erros de lógica de negócios.

Representação JSON 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
Campos
cause

enum (Cause)

Motivo da falha na reserva. (obrigatório)
rejectedCardType

enum (CreditCardType)

(obrigatório apenas se a causa for PAYMENT_ERROR_CARD_TYPE_REJECTED)
description

string

Esse campo é opcional e pode ser usado pelo parceiro para incluir informações adicionais a serem aplicadas na depuração. (opcional)
paymentFailure

object (PaymentFailureInformation)

Informações sobre falhas de pagamento.

Causa

Enumeração das causas da falha.

Enums
CAUSE_UNSPECIFIED Valor padrão: não usar, porque equivale a um "erro desconhecido"
SLOT_UNAVAILABLE O horário referenciado não está mais disponível.
SLOT_ALREADY_BOOKED_BY_USER O usuário já tem um agendamento para o horário disponível referenciado.
LEASE_EXPIRED A locação (se definida) expirou e não pode mais ser usada para a reserva solicitada.
OUTSIDE_CANCELLATION_WINDOW Não é possível realizar o cancelamento solicitado devido a restrições de tempo na política relacionada do comerciante.
PAYMENT_ERROR_CARD_TYPE_REJECTED Ocorreu um erro ao processar o pagamento porque o tipo de cartão de crédito fornecido não foi aceito pelo comerciante. O tipo de cartão de crédito precisa ser definido em rejectedCardType.
PAYMENT_ERROR_CARD_DECLINED Ocorreu um erro ao processar o pagamento porque o cartão de crédito fornecido foi recusado.
PAYMENT_OPTION_NOT_VALID Ocorreu um erro relacionado ao pacote/assinatura usado para pagar a reserva. Talvez não seja mais possível usá-los ou tenham expirado.
PAYMENT_ERROR Ocorreu um erro ao processar o pagamento desta reserva. Use esse valor para indicar uma falha geral relacionada ao pagamento somente se o erro não corresponder aos tipos mencionados acima.
USER_CANNOT_USE_PAYMENT_OPTION O usuário não pode usar a opção de pagamento especificada (por exemplo, ele está tentando usar um preço de uso único pela segunda vez).
BOOKING_ALREADY_CANCELLED O usuário está tentando cancelar uma reserva que já foi cancelada.
BOOKING_NOT_CANCELLABLE O usuário está tentando cancelar uma reserva que não pode ser cancelada.
OVERLAPPING_RESERVATION O usuário tem reserva com data muito próxima.
USER_OVER_BOOKING_LIMIT Ocorreu uma falha na reserva porque a pessoa ultrapassou o limite de reservas por usuário do agregador.
PAYMENT_REQUIRES_3DS1

Defina esse campo quando você quiser que a transação seja efetuada novamente, mas depois de passar pelo desafio/resposta 3DS1. O estado de falha da transação atual permanecerá como "Failed". A nova tentativa será considerada uma transação diferente.

Quando esse for o motivo da falha, você PRECISARÁ definir paymentFailure.3DS1_parameters. Se o motivo for outro, a causa atual será tratada como um PAYMENT_ERROR.

PaymentFailureInformation

Informações sobre falhas de pagamento.

Representação JSON 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Campos
threeds1Parameters

object (ThreeDS1Parameters)

Parâmetros usados por um agregador de RwG para iniciar um protocolo de autenticação 3DS1 com o usuário. Serão ignorados, a não ser que BookingFailure.cause esteja definido como PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Parâmetros que solicitam que o RwG realize um desafio 3DS1.

São definidos pela descrição do protocolo 3DS1 pelo EMVCo.

Representação JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Campos
acsUrl

string

O URL a partir do qual carregar um formulário para apresentar ao usuário para autenticação.
paReq

string

Solicitação de PaymentAuthentication A ser postado no formulário ACSUrl, se fornecido.
transactionId

string

Identificador usado pelo provedor ACS. A ser postado no formulário ACSUrl, se fornecido.
mdMerchantData

string

Dados do comerciante. A ser postado no formulário ACSUrl, se fornecido.