コンテンツ
Rapid Content APIは、Rapid API'sのすべてのプロパティのコンテンツへのアクセスを提供します。
施設 コンテンツAPI
リクエストされた言語で、リクエストされたアクティブな施設の施設 ID またはすべての施設コンテンツのリストを返します。
この API を使用して、検索条件に基づいて施設 ID またはすべての施設コンテンツを取得します。たとえば、前の月曜日以降に追加された施設のリストを取得したり、特定の施設 ID のリストに対応した施設コンテンツを取得したりします。
コンテンツファイルAPI
Rapid APIで利用可能な機能のひとつに、アクティブなプロパティのリストとその詳細をエクスポートする機能があります。2つのFile APIから選択できます。
施設カタログファイル
このAPIは、要求された言語のアクティブなプロパティの主要リストをダウンロードするためのリンクを返します。このレスポンスには、各施設の詳細情報が含まれています。このファイルを使用して施設の全リストを取得します。施設の詳細情報は、他のサプライヤーが提供する施設リストへのマッピングを行うときに役立ちます。
施設コンテンツファイル
このAPIは、要求された言語のすべてのアクティブなプロパティのすべてのコンテンツをダウンロードするためのリンクを返します。この応答には、施設レベル、客室レベル、料金レベルの情報が含まれます。このファイルを使用して、すべての施設の全コンテンツを取得します。施設のサブセットのみが必要な場合は、代わりに Property Content API を使用します。
公開停止中の施設
以前は予約可能だった施設が休業し、在庫内で公開停止になる場合があります。Inactive施設APIを使用すると、指定された日付以降アクティブでないすべての物件のリストをリクエストできます。Rapid API.
以下の例では、パートナーが最後に Property Content API または Property Content File API を使用してコンテンツキャッシュまたはストレージを更新しようとしたのは 5 月 31 日でした。これは、property_id
、そのシステムから削除されるべきオブジェクトの順序なしリストを表示します。Property Content API エンドポイントの次のパラメーターの 1 つ以上と組み合わせてこのエンドポイントを使用することで、コンテンツキャッシュまたはストレージを段階的に更新できます : date_added_start
、date_added_end
、date_updated_start
、または date_updated_end
。
例 :
リクエスト :
https://test.ean.com/v3/properties/inactive?since=2023-06-01
応答 :
[
{
"property_id": "10003243"
},
{
"property_id": "10012775"
},
{
"property_id": "10013765"
},
{
"property_id": "10017071"
},
{
"property_id": "10041102"
},
{
"property_id": "10042"
},
{
"property_id": "10074774"
},
{
"property_id": "10089905"
},
{
"property_id": "10091055"
},
{
"property_id": "10268276"
},
{
"property_id": "1029882"
},
{
"property_id": "103115"
},
{
"property_id": "10349744"
},
{
"property_id": "10373667"
},
{
"property_id": "1037667"
},
{
"property_id": "1039715"
},
{
"property_id": "10401509"
},
{
"property_id": "104201"
},
{
"property_id": "10465614"
},
{
"property_id": "10484434"
},
{
"property_id": "10488054"
},
{
"property_id": "10520425"
}
]
チェーンリファレンス
このパラメータはRapid API. チェーンとは、複数のブランドを関連付けることができる親会社です。
ブランドは 1 つのチェーンにのみ関連付けることができます。たとえば、ヒルトンワールドワイドというチェーンには、ダブルツリー、ハンプトン・イン、エンバシー・スイーツなどの複数のブランドが関連付けられています。
カリフォルニアのバケーションレンタル清掃
カリフォルニア州の新しい法律では、バケーションレンタル施設に対し、旅行者に義務付けられている清掃作業の開示を義務付けています。クリーニングタスクを表示できるようにAPIを変更しました。Rapid APIを使用する各パートナーは、清掃作業の表示方法が法律に準拠していることを確認する責任があります。
何が変わったのですか?
checkout
オブジェクトに、バケーションレンタル管理者から提供されたチェックアウトの指示を含む新しい指示フィールドを含めるために、Rapid APIを強化しました。
例 :
"checkout": {
"instructions": "<ul> <li>The host requests you complete the following cleaning tasks before checking out:</li><li>Start the dishwasher</li><li>Strip any used beds and gather used towels</li><li>Remove personal items</li><li>Turn off the lights</li> </ul>"
}
その他の参考情報
ローカライズ
language
パラメータは、ハイフンで区切られた言語と国コードのペアtwo-digitのみを使用します。コードを統合する前に、対応言語 を確認してください。
星評価
Rapid Content API で返される星評価は、家具、サービス、アメニティの点でその施設に一般的に期待できることについてお客様に指針を提供します。、星評価の仕組みについて詳しくご覧ください。
リファレンスリスト
多くの場合、Rapid Content API で提供される施設情報は ID で表されます。これらの ID の意味については、リファレンスリストを参照してください。このリファレンスリストは英語のみで提供されていますが、API ではローカライズ済みの名前を返します。
登録番号
Rapid Content APIの registry_number
パラメータは、単一または複数の登録詳細を返します。これらの詳細には、国ごとに必要な単語、文字、数字、特殊文字を含めることができます。当社では、法的および規制上の表示要件を遵守できるよう、これらの番号を提供しています。
**例 : **
"registry_number": "Property Registration Number 004071AAA-00004, IT005748GHFMUHG",
"registry_number": "IT00574-8GHFMUHG",
推奨施設
inventory opportunities ページは、以下の統合に関連するマッピングされていないプロパティのリストを提供します。Rapid API. 宿泊施設の供給は頻繁に変更されるため、定期的に確認して宿泊施設を追加したり、他のサプライヤーの宿泊施設にマッピングしたりする必要があります。こうすることで、ウェブサイトで旅行者に同じ宿泊施設が重複して表示されたり、旅行者が新しい宿泊施設を見逃したりすることがなくなります。
API の詳細
このページでコンテンツ関連のエンドポイント定義を調べてから、API Explorer または別のテストソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。
その他のリソース
すべての Rapid API エンドポイントを試してみたい場合でも、OpenAPI 仕様や Postman コレクションをダウンロードしたい場合でも、必要なリソースが用意されています。