特典と、「Google で予約」の両方のエンドツーエンド統合を行う場合、この 2 つを連携して、エンドツーエンドの予約フローに特典を表示できます。この 2 つの統合を行うかどうか不明な場合、またはどちらか 1 つの統合を希望する場合は、Google の担当者にお問い合わせください。
特典の統合と Google で予約の両方を完了したら、下記のように Google の技術担当者に連絡して、予約サーバーの変更を開始してください。
予約サーバーの変更
offer_id（特典フィードで指定された特典 ID）がCreateBookingRequestで指定されている場合は、特典が予約に適用されていることを確認してください。CreateBookingは、offer_idを指定しなくても機能します。- 予約に適用される特典は、
CreateBookingResponseに含める必要があります。予約に適用されるのは、リクエストに含まれる特典のみです。予約に特典が適用されていない場合は、レスポンスからこのフィールドを省略する必要があります。 offer_idが存在しない場合、またはリクエストされたスロットに適用できない場合は、CreateBookingResponseのBookingFailureでOFFER_UNAVAILABLEを返します。時間枠全体が利用不可の場合は、代わりにSLOT_UNAVAILABLEを返します。
テストケース
以下のテストケースは、「Google で予約」の統合が取引の統合で機能するために実施する必要があるテストケースです。具体的なプラットフォームのユースケースに基づいて、追加のテストを行うことを強くおすすめします。
- クーポンのない有効な時間枠を予約します
- 有効なクーポンを含む有効な時間枠を予約します
- 複数の特典がある有効なスロットを予約し、ランダムな特典を選択して、予約に正しい特典が適用されていることを確認します
- 有効なクーポンを含む有効なスロットを予約しましたが、特典の利用時間外です。
OFFER_UNAVAILABLEが返されます。 - 有効な特典を含む有効なスロットを予約しましたが、特典の利用期間を過ぎています。
OFFER_UNAVAILABLEが返されます。 - 無効な特典を含む有効なスロットを予約しましたが、その時点で別の有効な特典があります。これにより、
OFFER_UNAVAILABLEが返されます - 別の販売者のクーポンを含む時間枠を予約します。これにより、
OFFER_UNAVAILABLEが返されます。 - 存在しないクーポンを含む時間枠を予約します。
OFFER_UNAVAILABLEが返されます。 - 有効なクーポンを含み、利用できなくなった時間枠を予約します。これにより、
SLOT_UNAVAILABLEが返されます。 - 利用できなくなった特典で利用できなくなったスロットを予約します。これにより、
SLOT_UNAVAILABLEが返されます - 存在しない時間枠を予約します。
SLOT_UNAVAILABLEが返されます。
これらの変更が完了したら、サンドボックス環境で統合をテストしてください。テストが完了し、結果が信頼できる場合は、Google の技術担当者にご連絡ください。