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 somente 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

URL que direcionará o usuário para um formulário de autenticação.
paReq

string

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

string

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

string

Dados do comerciante. que será exibido no formulário ACSUrl, se fornecido.