同期予約とは、確定または不承認となった予約を指します。 リアルタイムで分析できます
非同期予約とは、販売者が確認または行う予約のことです。 下がります。
予約は、 提供します。特定の販売者とサービスについて 同期と非同期の両方の予約枠が存在する場合があります
適切な実装を判断するには、まず 広告枠がどのタイプに該当するか
- 同期予約のみを有効にする: すべての販売者とサービスの情報が即座に確定されます。
- 非同期予約を有効にする: 一部またはすべての販売者とサービスでは、販売者の手動操作が必要です 表示されます。
非同期予約の条件
- アクション センターでの非同期予約の変更は行えません。 サポートされません。
- 販売者は予約の承認または拒否を パートナーのオンライン システム(レストランのホストパネルなど)。呼び出しの ユーザーに代わって販売者が承認するか否かを判断 ユーザーが予約を不承認とすることはできません。
- 販売者からの新しい予約時間の提案はサポートされていません。「 予約リクエストは元の状態で承認または拒否される必要があります。
同期予約のみを有効にする
標準の実装のデフォルトは、同期予約です。お問い合わせください 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_MERCHANT
、FAILED
。これらの新しいステータス値は、 非同期予約の作成、不承認、失敗を処理できます - 予約の更新: 予約のステータスに対するすべての非同期更新。 予約は Booking Notification API の bookings.patch メソッドを使用します。
次の図は、確認モードと予約ステータスがどのように使用されるかを示しています。 一般的な非同期予約インタラクションで行われます。
<ph type="x-smartling-placeholder">![図 1: 非同期予約フロー](https://developers.google.cn/static/actions-center/images/enabling_async_1.png?authuser=1&hl=ja)
- 空き情報フィードが更新され、各空き情報スロットの 確認モードが指定されています。この情報は 予約の非同期的な性質を説明できるように フローの初期段階でユーザーに通知できます。
- 日時
BatchAvailabilityLookup
またはCheckAvailability
確認モードを渡します。可能であれば、同じ確認モードを 返されます。これにより、ユーザーに適切なメッセージが表示されるようになります。 - 日時
CreateBooking
確認モードを渡して 予想される確認モードを示します。非同期予約が リクエストが送信されると、予約のステータスとともに返されます。PENDING_MERCHANT_CONFIRMATION
。 - 販売者が予約リクエストを承認または拒否すると、 ステータスはリアルタイム更新の Booking Notification API で更新され、 bookings.patch メソッドを使用します。同意していない予約を自動拒否するには、 迅速に対応できた場合は、同じリアルタイム更新で メソッドを呼び出します。
空き情報フィード
空き情報フィードで、各スロットが同期型か同期型かを指定します。
使用できます。これを行うには、新しい confirmation_mode
を設定します。
表示されます。
// 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
を返します
。また予約が非同期の場合は
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 メソッド。
ステータスを更新するときは、必ず 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
は無視されます。
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