非同期予約を追加する

<ph type="x-smartling-placeholder">

同期予約とは、確定または不承認となった予約を指します。 リアルタイムで分析できます

非同期予約とは、販売者が確認または行う予約のことです。 下がります。

予約は、 提供します。特定の販売者とサービスについて 同期と非同期の両方の予約枠が存在する場合があります

適切な実装を判断するには、まず 広告枠がどのタイプに該当するか

非同期予約の条件

  • アクション センターでの非同期予約の変更は行えません。 サポートされません。
  • 販売者は予約の承認または拒否を パートナーのオンライン システム(レストランのホストパネルなど)。呼び出しの ユーザーに代わって販売者が承認するか否かを判断 ユーザーが予約を不承認とすることはできません
  • 販売者からの新しい予約時間の提案はサポートされていません。「 予約リクエストは元の状態で承認または拒否される必要があります。

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

標準の実装のデフォルトは、同期予約です。お問い合わせください Appointments End-to-End 統合に関するドキュメント

非同期予約を有効にする

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

  • 確認モード: 予約枠のすべての表現が変わりました。 予約方法を説明した confirmation_mode フィールドが その予約枠が確定します具体的な 次の予約枠の confirmation_mode: 次のとおりです。

    • 空室状況フィードでは、confirmation_mode は 可用性レベル
    • Booking Server API メソッドの場合、confirmation_mode は スロットレベルと
    • Real-Time Updates API のメソッドでは、confirmation_mode を指定します。 最小権限の原則に基づいて
  • 予約ステータス: 予約を表すすべての表現には、 予約の状態を表す status フィールド。3 回 新しい非同期ステータス値 PENDING_CONFIRMATION が導入されました。 DECLINED_BY_MERCHANTFAILED。これらの新しいステータス値は、 非同期予約の作成、不承認、失敗を処理できます
  • 予約の更新: 予約のステータスに対するすべての非同期更新。 予約は Booking Notification API の bookings.patch メソッドを使用します。

次の図は、確認モードと予約ステータスがどのように使用されるかを示しています。 一般的な非同期予約インタラクションで行われます。

<ph type="x-smartling-placeholder">
</ph> 図 1: 非同期予約フロー
図 1: 非同期予約フロー
  1. 空き情報フィードが更新され、各空き情報スロットの 確認モードが指定されています。この情報は 予約の非同期的な性質を説明できるように フローの初期段階でユーザーに通知できます。
  2. 日時 BatchAvailabilityLookup または CheckAvailability 確認モードを渡します。可能であれば、同じ確認モードを 返されます。これにより、ユーザーに適切なメッセージが表示されるようになります。
  3. 日時 CreateBooking 確認モードを渡して 予想される確認モードを示します。非同期予約が リクエストが送信されると、予約のステータスとともに返されます。 PENDING_MERCHANT_CONFIRMATION
  4. 販売者が予約リクエストを承認または拒否すると、 ステータスはリアルタイム更新の Booking Notification API で更新され、 bookings.patch メソッドを使用します。同意していない予約を自動拒否するには、 迅速に対応できた場合は、同じリアルタイム更新で メソッドを呼び出します。

空き情報フィード

空き情報フィードで、各スロットが同期型か同期型かを指定します。 使用できます。これを行うには、新しい confirmation_mode を設定します。 表示されます。

<ph type="x-smartling-placeholder">
// 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

利用可能な API リクエストを使用して、予約の正しいステータスを返すようにしてください。 オプションは次のとおりです。

// 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 で、 指定された予約の集約スロットの現在の confirmation_mode を返します 。また予約が非同期の場合は statusPENDING_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 メソッド Availabilityconfirmation_modeCONFIRMATION_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 メソッド。

ステータスを更新するときは、必ず status フィールド名を updateMask

ステータス 説明
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 は無視されます。

<ph type="x-smartling-placeholder">
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 つのメールが ユーザーに送信された予約のステータス。

<ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">
    </ph>
  • PENDING_MERCHANT_CONFIRMATION
  • CONFIRMED
  • DECLINED_BY_MERCHANT
  • FAILED
  • CANCELED