Ta strona została przetłumaczona przez Cloud Translation API.

Dodawanie rezerwacji asynchronicznych

Rezerwacje synchroniczne to rezerwacje potwierdzone lub odrzucone w czasie rzeczywistym.

Rezerwacje asynchroniczne to rezerwacje potwierdzone lub odrzucone przez sprzedawcę w późniejszym czasie.

Rezerwacja jest określona jako synchroniczna lub asynchroniczna na poziomie dostępności. Oznacza to też, że w przypadku danego sprzedawcy i usługi mogą być zarówno synchroniczne, jak i asynchroniczne przedziały dostępności.

Aby określić odpowiednią implementację, najpierw określ, do której kategorii należy Twój asortyment:

Włączenie tylko rezerwacji synchronicznej: informacje o wszystkich sprzedawcach i usługach są zatwierdzane natychmiast.
Włączanie rezerwacji asynchronicznych: niektórzy lub wszyscy sprzedawcy i usługi wymagają ręcznego potwierdzenia sprzedawcy.

Asynchroniczne kryteria rezerwacji

Modyfikacja rezerwacji asynchronicznej w Centrum działań nie jest obsługiwana.
Sprzedawcy powinni mieć możliwość zaakceptowania lub odrzucenia rezerwacji w systemie online partnera (np. w panelu hosta restauracji). Wywołanie sprzedawcy w imieniu użytkownika w celu ustalenia, czy akceptuje on lub odrzuca rezerwację, jest niedozwolone.
Oferta sprzedawcy dotycząca nowego terminu rezerwacji nie jest obsługiwana. Prośba o rezerwację musi zostać zaakceptowana lub odrzucona w pierwotnym stanie.

Włączanie tylko rezerwacji synchronicznych

W standardowej implementacji domyślnie ustawione są rezerwacje synchroniczne. Więcej informacji znajdziesz w dokumentacji dotyczącej kompleksowej integracji spotkań.

Włączanie rezerwacji asynchronicznej

Jeśli niektórzy lub wszyscy sprzedawcy używają asynchronicznego procesu rezerwacji, należy wprowadzić te zmiany:

Tryb potwierdzenia: wszystkie reprezentacje przedziałów dostępności zawierają teraz pole confirmation_mode, które opisuje sposób potwierdzania rezerwacji w tym przedziale dostępności. Określ confirmation_mode każdego przedziału dostępności dla tych elementów:
- W pliku danych o dostępności wartość confirmation_mode jest określona na poziomie dostępności
- W metodach Booking Server API pole confirmation_mode jest określone na poziomie przedziału.
- W metodach interfejsu API aktualizacji w czasie rzeczywistym confirmation_mode jest określony na poziomie dostępności
Stan rezerwacji: wszystkie wystąpienia rezerwacji zawierają pole status, które wskazuje stan rezerwacji. Wprowadzono 3 nowe asynchroniczne wartości stanu: PENDING_CONFIRMATION, DECLINED_BY_MERCHANT i FAILED. Używaj tych nowych wartości stanu podczas przetwarzania kompozycji, odrzuceń i niepowodzeń rezerwacji asynchronicznych.
Aktualizacje rezerwacji: wszystkie asynchroniczne aktualizacje stanu rezerwacji należy zgłaszać za pomocą metody bookings.patch interfejsu Booking Notification API.

Poniższy diagram przedstawia, jak tryb potwierdzenia i stan rezerwacji są używane podczas typowej asynchronicznej interakcji związanej z rezerwacją.

Rysunek 1. Asynchroniczny proces rezerwacji — **Rys. 1.** Proces rezerwacji asynchronicznej

Pliki danych o dostępności zostały zaktualizowane, aby określić tryb potwierdzenia każdego przedziału dostępności. Ważne jest, aby umieścić te informacje w pliku danych, abyśmy mogli wyjaśnić użytkownikowi asynchroniczny naturę rezerwacji na wczesnym etapie procesu.
Gdy wywoływane jest BatchAvailabilityLookup lub CheckAvailability, przekazujemy tryb potwierdzenia i w miarę potrzeb zwracamy ten sam tryb potwierdzenia. Dzięki temu użytkownik zobaczy odpowiedni komunikat.
Gdy zostanie wywołany CreateBooking, przekazujemy tryb potwierdzenia, aby wskazać oczekiwany tryb potwierdzenia. Po przesłaniu asynchronicznej prośby o rezerwację jest ona zwracana ze stanem PENDING_MERCHANT_CONFIRMATION.
Gdy sprzedawca zaakceptuje lub odrzuci prośbę o rezerwację, stan rezerwacji jest aktualizowany w czasie rzeczywistym za pomocą metody bookings.patch interfejsu Booking Notification API. Jeśli chcesz automatycznie odrzucać rezerwacje, na które nie odpowie w odpowiednim czasie, zrób to w ten sam sposób, korzystając z tej samej metody aktualizacji w czasie rzeczywistym.

Pliki danych o dostępności

W pliku danych dostępności określ, czy każdy przedział jest synchroniczny czy asynchroniczny. Aby to zrobić, skonfiguruj nowe pole confirmation_mode.

Uwaga: pole confirmation_mode jest przechowywane w sekcji dostępności w kanałach dostępności i aktualizacjach w czasie rzeczywistym, ale to pole jest przechowywane na poziomie przedziału dla interfejsów API serwera rezerwacji.

// 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;
}

Chociaż tryb potwierdzenia jest uważany za synchroniczny, jeśli nie został określony, zdecydowanie zalecamy jawne wskazanie trybu, ponieważ zapobiega to przypadkowemu pominięciu.

Dane asynchroniczne

{
  "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"
    }
  ]
}

Synchronizuj

{
  "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"
    }
  ]
}

Asynchronizacja i synchronizacja

{
  "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"
    }

  ]
}

Serwer rezerwacji

BatchAvailabilityLookup lub CheckAvailability

W BatchAvailabilityLookupResponse (BAL) lub CheckAvailabilityResponse (CA) zwracaj tę samą wartość confirmation_mode, która została określona w pliku danych o dostępności i przekazana za pomocą BatchAvailabilityLookupRequest lub CheckAvailabilityRequest.

BAL asynchroniczne

{
  "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
    }
  ]
}

Synchronizacja BAL

{
  "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
    }
  ]
}

Asynchroniczny CA

{
  "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"
}

Synchronizacja CA

{
  "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

Zwróć uwagę na prawidłowy stan rezerwacji, korzystając z dostępnych opcji:

// 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;
}

W CreateBookingResponse zwracaj bieżącą wartość confirmation_mode dla zagregowanego przedziału rezerwacji podanego w CreateBookingRequest. Dodatkowo, jeśli rezerwacja jest asynchroniczna, ustaw status na PENDING_MERCHANT_CONFIRMATION. Sprawdź, czy parametr confirmation_mode jest zgodny z oczekiwaniami użytkownika i którym usługa Zarezerwuj z Google nie powinna wprowadzać użytkownika w błąd.

Dane asynchroniczne

{
  "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"
  }
}

Synchronizuj

{
  "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

We wstępnej wersji asynchronicznej zmiany wprowadzone przez użytkownika w dotychczasowej rezerwacji nie są obsługiwane. Zamiast tego użytkownik powinien anulować rezerwację i utworzyć nową.

Aktualizacje w czasie rzeczywistym

W przypadku aktualizacji dostępności w czasie rzeczywistym należy określić confirmation_mode. Ma to zastosowanie w przypadku tych metod:

RTU zasobów reklamowych (ReplaceServiceAvailability lub BatchReplaceServiceAvailability)

Przy użyciu metody availability.replace (zbiorczej) lub metody services.availability.replace ustaw confirmation_mode na CONFIRMATION_MODE_ASYNCHRONOUS w Availability

Dane asynchroniczne

{
  "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"
        }
      ]
    }
  ]
}

Synchronizuj

{
  "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"
        }
      ]
    }
  ]
}

Asynchronizacja i synchronizacja

{
  "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"
        }
      ]
    }
  ]
}

Interfejs API rezerwacji powiadomień

Asynchroniczne aktualizacje stanu rezerwacji należy wprowadzać za pomocą metody bookings.patch interfejsu Booking Notification API.

Podczas aktualizowania stanu pamiętaj, aby w polu updateMask uwzględnić nazwę pola status.

Stan	Opis
POTWIERDZONO	sprzedawca potwierdził rezerwację
NIEPOWODZENIE	partner nie mógł potwierdzić ani odrzucić rezerwacji u sprzedawcy
DECLINED_BY_MERCHANT	sprzedawca odrzucił rezerwację

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"}

W przypadku niepowodzenia rezerwacji ustaw stan rezerwacji na FAILED i podaj atrybut „rezerwacja_nieudana”. Jeśli stan ma wartość inny, booking_failure jest ignorowana.

Uwaga: pola booking_failure są przekazywane jako argumenty zapytania w adresie 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"}

E-maile z powiadomieniem

W przypadku rezerwacji asynchronicznych użytkownicy mogą otrzymać 5 potencjalnych e-maili związanych ze stanem rezerwacji.

PENDING_MERCHANT_CONFIRMATION
CONFIRMED
DECLINED_BY_MERCHANT
FAILED
CANCELED