このページは Cloud Translation API によって翻訳されました。

非同期予約を有効にする

同期予約とは、リアルタイムで確認または拒否される予約のことです。

非同期予約は、販売者が後で確認または拒否する予約です。

予約は、可用性レベルで同期または非同期のいずれかとして指定されます。また、特定の販売者とサービスには、同期と非同期の両方の可用性スロットが存在する可能性があります。

適切な実装を判断するには、まず、インベントリが該当するカテゴリを特定します。

同期予約のみを有効にする: すべての販売者とサービスがすぐに確定します。
非同期予約を有効にする: 一部またはすべての販売者とサービスで、販売者による手動確認が必要です。

非同期予約の条件

「Google で予約」での非同期予約の変更はサポートされていません。
支払いが必要な非同期予約はサポートされていません。
販売者は、パートナーのオンラインシステム（レストランのホストパネルなど）を通じて予約を承認または拒否できる必要があります。ユーザーに代わって販売者に電話をかけて、販売者が予約の承認または拒否を行うかどうかを判断することはできません。
販売者からの新しい予約時間の提案はサポートされていません。予約リクエストは元の状態で承認または拒否する必要があります。

同期予約のみを有効にする

標準の実装のデフォルトは、同期予約です。詳しくは、エンドツーエンドの統合ガイドをご覧ください。

非同期予約を有効にする

販売者の一部またはすべてが非同期の予約フローを使用している場合、次の変更を行う必要があります。

確認モード: 予約枠のすべての表現に、その予約枠の予約確認方法を示す confirmation_mode フィールドが追加されました。以下について、各可用性スロットの confirmation_mode を指定します。
- 在庫状況フィードでは、confirmation_mode は在庫状況レベルで指定されます。
- Booking Server API メソッドでは、confirmation_mode はスロットレベルで指定されます。
- Real-Time Updates API メソッドでは、confirmation_mode が可用性レベルで指定されます。
予約ステータス: 予約のすべての表現には、予約の状態を表す status フィールドが含まれています。PENDING_CONFIRMATION、DECLINED_BY_MERCHANT、FAILED の 3 つの新しい非同期ステータス値が導入されました。新しい予約値は、非同期の予約の作成、不承認、失敗を処理する際に使用します。
予約の更新: 予約のステータスに対する非同期の更新はすべて、Booking Notification API の bookings.patch メソッドで報告する必要があります。

下の図は、一般的な非同期予約操作で、確認モードと予約ステータスがどのように使用されるかを示しています。

各在庫状況スロットの確認モードが指定されるように、在庫状況フィードが更新されました。予約の非同期的な性質をフローの早い段階でユーザーに説明できるように、この情報をフィードに含めることが重要です。
BatchAvailabilityLookup または CheckAvailability が呼び出されると、確認モードが渡されます。同じ確認モードが返されるのが理想的です。これにより、ユーザーに適切なメッセージを表示できます。
CreateBooking が呼び出されると、予想される確認モードを示すため、確認モードが渡されます。非同期の予約リクエストが送信されると、ステータス PENDING_MERCHANT_CONFIRMATION で予約が返されます。
販売者が予約リクエストを承認または拒否すると、リアルタイム更新の Booking Notification API の bookings.patch メソッドによって予約ステータスが更新されます。期限までに返答しない予約を自動で拒否する場合は、同じリアルタイム更新方法で行います。

空き情報フィード

空室状況フィードで、各スロットが同期か非同期かを指定します。これを行うには、新しい confirmation_mode フィールドを設定します。

注: confirmation_mode は空室状況フィードとリアルタイム更新の空室状況セクションに保存されますが、このフィールドは Booking Server API のスロットレベルに保存されます。

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

モードを指定しないと、確認モードは同期的と見なされますが、偶発的な省略による混乱がなくなるため、モードを明示的に指定することを強くおすすめします。

非同期

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

同期

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

非同期と同期

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

  ]
}

予約サーバー

BatchAvailabilityLookup または CheckAvailability

BatchAvailabilityLookupResponse（BAL）または CheckAvailabilityResponse（CA）で、可用性フィードで指定されたのと同じ confirmation_mode を返し、BatchAvailabilityLookupRequest または CheckAvailabilityRequest を介して渡します。

BAL - 非同期

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

{
  "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 - 非同期

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

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

以下のオプションを使用して、予約に対して正しいステータスを返すようにしてください。

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

CreateBookingResponse で、CreateBookingRequest で提供される予約の集計スロットの現在の confirmation_mode を返します。また、予約が非同期の場合は、status を PENDING_MERCHANT_CONFIRMATION に設定します。confirmation_mode がユーザーに表示されている内容であり、ユーザーの混乱を避けるために「Google で予約」に登録されていることを確認してください。

非同期

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

同期

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

非同期の初回リリースでは、既存の予約に対するユーザーの変更はサポートされません。代わりに、ユーザーが予約をキャンセルして新しい予約を作成する必要があります。

リアルタイム更新

在庫状況をリアルタイムで更新するには、confirmation_mode を指定する必要があります。これは次のメソッドに適用されます。

Inventory RTU（ReplaceServiceAvailability または BatchReplaceServiceAvailability）

availability.replace（バッチ）メソッドまたは services.availability.replace メソッドを使用して、Availability の confirmation_mode を CONFIRMATION_MODE_ASYNCHRONOUS に設定します。

非同期

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

同期

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

非同期と同期

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

Booking Notification API

予約ステータスを非同期で更新する場合は、Booking Notification API の bookings.patch メソッドを使用する必要があります。

ステータスを更新する場合は、updateMask に status フィールド名が含まれていることを確認してください。

ステータス	説明
CONFIRMED	販売者が予約を確認しました
FAILED	パートナーが販売者との予約を確認または拒否できませんでした
DECLINED_BY_MERCHANT	販売者が予約を拒否しました

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

予約が失敗した場合は、予約ステータスを FAILED に設定し、booking_failure を指定します。ステータスが他の値に設定されている場合、booking_failure は無視されます。

注: booking_failure フィールドは、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"}

メール通知

非同期予約の場合、ユーザーに送信される予約のステータスに関連するメールが 5 つ表示されます。

PENDING_MERCHANT_CONFIRMATION
CONFIRMED
DECLINED_BY_MERCHANT
FAILED
CANCELED