Esta página foi traduzida pela API Cloud Translation.

Adicionar agendamentos assíncronos

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 o confirmation_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
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 e FAILED. 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 — **Figura 1:** fluxo de reserva assíncrona

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 ou CheckAvailability é 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 status PENDING_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. .

Observação:o confirmation_mode é armazenado no arquivo de dos feeds de disponibilidade e das atualizações em tempo real. No entanto, é armazenado no nível do horário das APIs Booking Server.

// 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.

Observação:os campos booking_failure são transmitidos como uma consulta. argumentos no URL.

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