Developer Hub
これは自動生成された翻訳です。

注: EGIは、現在すべてのパートナーでご利用いただけません。このリソースの利用にご興味をお持ちの方は、アカウントマネージャー までご連絡いただき、EGIへのアクセスに必要な要件について詳しくお尋ねください。

Rapid Lodging APIのグローバル在庫が拡充されました

世界中の在庫を拡充し、グローバルな規模で競争力を高めます

エクスペディアのグローバル在庫拡大(EGI)を利用すれば、世界中で34,000件以上の宿泊施設との競争に打ち勝つことができます。また、在庫は定期的に追加されています。これには、新たに確保した物件や、現在確保済みの物件における追加の在庫が含まれます。

技術的な詳細

EGIはRapid API, の標準機能には含まれていませんが、ご要望に応じて明示的に有効化することができます。この機能には、標準的な在庫管理とは異なる動的な挙動や統合パターンが含まれており、コンテンツの取り込み、ショッピング、予約の各ワークフローにおいて、特に注意を払う必要があります。

コンテンツファイル

EGI向けのRapid Content FileおよびCatalog File APIは、現在、English-languageのコンテンツのみをサポートしています。お使いのシステムでローカライズされた(non-English))コンテンツファイルが必要な場合は、施設 コンテンツAPIおよび地理APIを使用して、ローカルでそれらを生成することができます。これらのAPIは、すべてのコンテンツ言語に対応したreal-timeストリーミング機能と柔軟なデータ処理機能を提供しており、JSON-formatted APIのレスポンスから必要な情報を簡単に抽出することができます。生のJSONレスポンスを、後で処理するためにローカルに保存したり、データベースへのインポートやその他の用途に合わせて変換したりすることができます。

>> コンテンツAPIについて詳しくはこちら
>> ジオグラフィーAPIについて詳しくはこちら

Geography APIを使用して、特定の地域のプロパティ一覧をリクエストする例:

/regions?country_code=US&language= it-IT&include=property_ids_expanded&include=property_ids

施設 コンテンツAPIを使用してカタログコンテンツをリクエストする例:

/properties/content?language=it-IT&supply_source=expedia&property_id={property_id}&include=catalog

EGI向けのコンテンツ連携の導入を優先しつつ、ショッピングおよび予約のワークフローの見直しに追加の時間を割くという選択肢もあれば、EGIの準備が整ったと判断した時点で、これら3つのコンポーネントをまとめて導入することも可能です。設定の詳細については、担当の統合コンサルタントまでお問い合わせください。

部屋のデータ整合

お使いのシステムが 施設 コンテンツAPIと完全に同期される前に、Shopping APIに新しい 施設 ルームが表示される場合があります。一貫したユーザー体験を維持するためには、これらの部屋を一時的に顧客への表示対象から除外するか、新しい部屋に対してreal-timeコンテンツAPIを呼び出すか、あるいはローカルコンテンツの更新頻度を高めてデータの遅延を最小限に抑えることをご検討ください。

>> ショッピングAPIについて詳しく見る

レート識別子

EGIのレートは、標準在庫とは異なる構造となっており、より動的なデータモデルに基づいています。これらのレートには固定値がないため、Shopping APIでは、施設Content APIの値とは一致しない動的な「rate_id」値として返されます。この動的な文字列値は、数字、アルファベット、およびその他のさまざまな記号で構成されており、Shopping APIの応答ごとに異なる場合があります。このため、rate_id の値は不安定であり、永続的な識別子や主キーとして使用すべきではありません。システムでプロセスごとに料金を区別する必要がある場合は、ポリシー属性とオファーの特徴を組み合わせて照合することをご検討ください。詳細については、パートナーポータルをご参照ください。

>> プロセスごとのレートの見分け方についてお読みください

Shopping APIのレスポンスにおけるrate_id値の例:

[
  {
    "property_id": "ABC152",
    "status": "available",
    "rooms": [
      {
        "id": "XYZ652",
        "room_name": " Deluxe Double ",
        "rates": [
          {
            "id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
            … …

ベッドの配置の多様性

例外的な状況において、一部の客室には指定されたベッド構成がない場合があります。その場合は、Content APIおよびShopping APIの両方で、bed_groups IDが「0」となり、説明欄に「ベッド未指定」と表示されます。これは、施設 が、以下の際のベッドの配置を決定することを意味します。check-in. このような事態は稀ではありますが、貴社のシステムではお客様にその旨を随時お知らせするとともに、お客様にご要望が強くおありの場合は、当社のカスタマーオペレーションチームへ特別なご要望をお伝えできるようお手伝いしてください。

ショッピングAPIのレスポンスにおける、ベッド構成が指定されていない例:

{
  "bed_groups": {
    "0": {
      "id": "0",
      "description": "Bed Not Specified",
      "links": {
        "price_check": {
          … …

Hold と Resume 機能

一部のEGI料金プランは、Booking APIの「保留」および「再開」ワークフローと互換性がなく、保留を試みるとエラーが返されます。顧客体験の低下を防ぐため、Shopping APIのレスポンスで「holdable rate」フラグをリクエストし、それに従って適切なワークフローを適用することができます。

>>「保留」と「再開」について詳しくはこちら

ホールド可能レートフラグの要求例:

Request:
/properties/availability?... …&include=rooms.rates.holdable

Response:
… …
"rooms": [
  {
    "id": "XYZ652",
    "room_name": "Deluxe Double Room",
    "rates": [
      {
        "id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
        “holdable”: true,
        … …

Post-booking特長

Booking APIを通じて予約が確定すると、その予約情報はManage Booking APIに送信されます。「post-booking」の機能(ソフトチェンジ、ハードチェンジ、および 施設 メッセージセンターなど)にアクセスするためのトークンリンクも、「予約管理API」で利用可能になります。場合によっては、トークンのリンクが利用可能になるまでに最大5分ほどかかることがあります。これらの機能はすべての予約で利用できるわけではないため、システム内で適切に処理していただく必要がありますので、ご注意ください。

>>「予約管理API」をご覧ください

EGIにおける主な相違点

機能/動作標準在庫世界的な在庫の拡充
デフォルトでの利用可能状況デフォルトで有効になっていますご要望に応じて有効化いたします
レート識別子静的、永続的変動的であり、店舗ごとに異なります
コンテンツソリューションファイルAPIおよびストリーミングコンテンツAPIに対応しています英語コンテンツについてはファイルAPIに対応しており、すべての言語のストリーミングコンテンツについてはコンテンツAPIに対応しています
コンテンツの同期要件人気物件の毎日の同期人気物件の毎日の同期
ベッドの組み合わせ指定済みごくまれに、指定されていない場合があります
Hold と Resume 機能すべての予約でご利用いただけます一部の予約でご利用いただけます
Post-booking特長すべての予約でご利用いただけます一部の予約でご利用いただけます
このページは役に立ちましたか ?
このコンテンツに改善が必要な点があれば、
サービス向上にご協力いただきありがとうございます。