利用開始の準備
最初のステップは、最終的な添付リンクURLを生成するために必要なすべての情報を収集することです。
必要な情報は以下の通りです：
| 要件 | 発生元 | 説明 |
|---|---|---|
| パートナーの識別子 | 共有者Expedia Group. | パートナーIDはリクエストパラメータで使用される文字列値です。 例： PartnerId =partnername_hotel_conf_overlay |
| 秘密鍵/秘密鍵 | 共有者Expedia Group. | 秘密鍵は、パートナーIDごとにExpedia Group、安全に共有される英数字の文字列で、署名の生成に使用されます。このキーは36文字です。例えば 1ページ目 • PartnerId = partnername_hotel_conf_overlay• シークレット・キー = 6f437404-261d-4beb-a7fc-43b92f694831ページ2： • 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 |