利用開始の準備
まず、最終的な添付リンクのURLを生成するために必要な情報をすべて収集します。
以下に、必要な詳細の一覧を記載いたします：
| 要件 | 発生元 | 説明 |
|---|---|---|
| パートナー識別子 | 以下の方々が共有しますExpedia Group. | パートナーIDは、リクエストパラメータで使用される文字列値です。 例えば： PartnerId =partnername_hotel_conf_overlay |
| 秘密鍵／プライベートキー | 以下の方々が共有しますExpedia Group. | 秘密鍵とは、Expedia Groupが各パートナーIDごとに安全に共有する英数字の文字列であり、署名の生成に使用されます。このキーは36文字です。例： 1ページ目： • PartnerId = partnername_hotel_conf_overlay• 秘密鍵 = 6f437404-261d-4beb-a7fc-43b92f6948312ページ目： • PartnerId = partnername_hotel_itin_overlay• 秘密鍵 = 89f37407-821r-3des-a7f5-ghb92f694294 |
| トラッキングコード | 以下の方々が共有しますExpedia Group. | パートナーサイトへの掲載による収益の帰属を追跡するために使用されるトラッキングコードです。 |
| エンドポイント | xsell-redirect-pwa | |
| HMAC-SHA1アルゴリズムライブラリ | https://commons.apache.org/crypto/download_crypto.cgi | 署名の生成には、HMAC-SHA1アルゴリズムライブラリが使用されています。 https://download.java.net/java/early_access/panama/docs/api/java.base/javax/crypto/package-summary.html |
| URLのエンコードUTF-8 | http://en.wikipedia.org/wiki/Percent-encoding | |
| ホテル検索結果ページの最初のURLを作成するためのディープリンクガイドです。 | ディープリンク | 標準のディープリンクの作成方法については、こちらの記事に詳しく記載されています。 注： の「Destinations」は、テンプレートサイトでサポートされているロケールと一致している必要があります。 |
メール添付リンクのURLリクエストパラメータ
注： のリクエストパラメータは、大文字と小文字が区別されます。大文字と小文字の区別が正しくない場合、エラーが発生します。
| パラメーター | タイプ | 必須／任意 | 説明 | 値の例 |
|---|---|---|---|---|
PartnerId | 文字列 | 必須 | 提供元：Expedia Group. | partnername-POS-Ext-Flight-Conf-EmailDL |
url | 文字列 | 必須 | ディープリンクガイドに従い、パートナードメイン、検索パラメータ、およびトラッキングコードを使用して、ホテルの検索結果ページへのディープリンクリクエストURLを作成してください。トラッキングコード（mdpcid）が確実に含まれていること、および出力パラメータの値が適切であることをご確認ください。URL-encoded. >> ディープレンクガイドをご覧ください | url = https%3A%2F%2Fexpedia.com%2Fgo%2Fhotel%2Fsearch%2FDestination%2F2025-12-22%2F2025-12-25%3Fmdpcid%3DMDPCID=Expedia-IE.DPS.en_IE.confemail.attachDL.Flightl%26CityName%3DORD%26SortBy%3Ddistance%26NumRoom%3D1%26NumAdult1%3D3%26NumChild1%3D2%26Rm1child1age%3D9%26Rm1child2age%3D6n |
outboundEndDateTime | ISO 8601規格に準拠した日付の文字列表現です。 | 必須 | 旅行の目的地への到着日時を指定してください。ISO 8601規格に準拠した日付、時刻、およびタイムゾーンのみを含める必要があります。 このパラメータの値はエンコードする必要があります。 | 2025-10-30T20%3A12%3A17.928020Z |
originTLA | 文字列（3文字） | 必須 | 旅行の出発地であるIATAの空港コードを指定してください。 | LAS |
returnStartDateTime | ISO 8601規格に準拠した日付の文字列表現です。 | 任意 - 往復の場合にのみ必要です | 目的地からの帰りの日時を指定してください。ISO 8601規格に準拠した日付、時刻、およびタイムゾーンのみを含めることができます。 このパラメータの値はエンコードする必要があります。 | 2025-11-10T20%3A12%3A17.928020Z |
destinationTLA | 文字列（3文字） | 必須 | 旅行先の空港コード（IATA）を指定してください。 | JFK |
bookingDateTime | ISO 8601規格に準拠した日付の文字列表現です。 | 必須 | ご予約の日時をご指定ください。ISO 8601規格に準拠した日付、時刻、およびタイムゾーンのみを含めることができます。 このパラメータの値はエンコードする必要があります。 | 2025-07-25T20%3A12%3A17.928020Z |
bookingStatus | 文字列 | 任意 - 記載がない場合は、ご予約が確定しているものとみなします。 | このパラメータの有効な値は以下の通りです： • confirmed• pending• failed割引料金は、「 bookingStatus」が確定した場合にのみ適用されます。 | confirmed |
attachDL | ブール型 | 必須 | 割引適用率を有効にするには、この値を「true」に設定してください。 | true |
signature | 文字列 | 必須 | パートナーが、提供された秘密鍵に基づいてserver-sideを生成しました。Expedia Group. この文字列の長さは、ちょうど27文字です。生成されたバイナリ署名をエンコードしてください。 | BcND1F7KElTyGtyUHeXHd2JJLFs |