プロパティ フィードリファレンス
- [アーティクル]
-
-
Bingでホテル価格広告を作成する場合は、プロパティ フィードを使用して、宣伝するホテルに関するBing情報を提供する必要があります。
価格フィードを送信する前に、プロパティ フィードを定義してインポートBing必要があります。
プロパティ フィードの作成については、「プロパティ フィード の作成」を参照してください。
注:
要素は、 Hotel XSD によって定義された順序で指定する必要があります (このトピックに記載されています)。
Listings
プロパティ フィードの最上位要素を定義します。
要素 |
説明 |
Children |
リスト |
プロパティ フィードの最上位要素。 |
リストの種類 |
リストの種類
フィード内のホテルの一覧を定義します。
要素 |
説明 |
Children |
language |
必須です。 データ型は文字列です。
フィード内のホテル データが書き込まれる言語。 2 文字の ISO 639 言語コードを使用して言語を指定します。 たとえば、英語には en を使用します。
|
なし |
リスティング |
ホテルのリストを定義します。 フィードに各ホテルの listing 要素を含めます。 |
リストの種類 |
リストの種類
ホテルを定義します。
要素 |
説明 |
Children |
id |
必須です。 データ型は文字列です。
フィード内のホテルを一意に識別する不透明なユーザー定義 ID。
Price フィードを作成するときは、Price フィードの Property 要素でこの ID を使用してホテルを識別します。 |
なし |
name |
必須です。 データ型は文字列です。
ホテルの名前。 名前には、最大 200 文字を含める場合があります。 |
なし |
address |
必須です。 データ型は文字列型または コンポーネント型です。
ホテルの番地。
注:- アドレスを指定するには、
address 要素の本文で自由形式のテキストを使用するか、 component 子要素を使用してアドレスのコンポーネントを指定します (「 コンポーネントの種類」を参照)。 -
component 要素を使用してアドレスのコンポーネントを指定することをお勧めします。 - 自由形式のテキストを使用する場合は、アドレスの各コンポーネントをコンマで区切ります。 たとえば、1234 Billings Way、Redmond、WA、98030 などです。
|
コンポーネントの種類 |
country |
必須です。 データ型は文字列です。
ホテルがある国。 2 文字の ISO 3116 国コードを使用して国を指定します。 たとえば、米国には US を使用します。 |
なし |
latitude |
必須です。 データ型は 10 進数です。
ホテルの地理的座標の緯度。
注:- 緯度と経度は、
phone を指定しない場合にのみ必要です。 電話と地理的な座標の両方を指定することをお勧めします。 - 緯度は、-90.0 ~ 90.0 の範囲である必要があります。
-
Location API または別の GeoCoding ツールを使用して座標を生成します。
|
なし |
longitude |
必須です。 データ型は 10 進数です。
ホテルの地理的座標の経度。
注:- 緯度と経度は、
phone を指定しない場合にのみ必要です。 電話と地理的な座標の両方を指定することをお勧めします。 - 経度は-180.0 ~ 180.0 の範囲である必要があります。
-
Location API または別の GeoCoding ツールを使用して座標を生成します。
|
なし |
電話 |
必須です。 データ型は文字列です。
お客様がホテルに連絡するために使用する電話番号の一覧。
属性:- type - 必須。 指定された電話番号の種類。 使用可能な値は次のとおりです。
- メイン - 必須。 ホテルのメイン音声電話番号。
- tollfree - 省略可能。 ホテルのフリーダイヤルの音声電話番号。
- fax - 省略可能。 ホテルの FAX 電話番号。
- tdd - 省略可能。 聴覚障頉者用のホテルの通信機器。
- mobile — 省略可能。 ホテルの携帯電話番号。
注:- 電話番号は、
latitude と longitude を指定しない場合にのみ必要です。 電話と地理的な座標の両方を指定することをお勧めします。 - 一覧の一意の電話番号を指定します。
- 読みやすくするために、電話番号にダッシュ、スペース、またはかっこを使用します。 たとえば、"6102223333" ではなく "610-222-3333" または "(610) 222-3333" を使用します。
- 各
phone 要素に指定する電話番号は 1 つだけです。 650-123-2222/33 など、複数の数値を指定しないでください。 - 電話番号には、最大 7 桁の延長が含まれている場合があります。 拡張機能の前に、"ext"、"extn"、および "x" のいずれかの省略形を指定します。 たとえば、"408-555-1111x12345" や "408-555-1111 x12345" などです。
- 電話番号にアルファベット文字を含めないようにしてください。
- 各リストでは、電話番号の種類として"メイン"、"mobile"、"tollfree"、"fax"、または "tdd" のいずれかを指定する必要があります (該当する場合)。
- 電話番号に国番号が含まれている場合は、その前に "+" を付けます。 たとえば、国コードが 65 のシンガポールの数値の場合は "+65 6722-2323"、国コードが 001 である米国の数値の場合は "+001 (408) 555-1111" などです。
|
なし |
category |
省略可能。 データ型は文字列です。
ホテルの種類を識別するカテゴリ。 予期される形式は 、vacation_rental または ホテル の後にパイプ文字とカスタム値が続きます。 たとえば、 vacation_rental |'カスタム値' または ホテル |'custom value'
カスタム値の一覧については、「 ロッジング プロパティ カテゴリ」を参照してください。 |
なし |
content |
省略可能。 データ型は コンテンツ タイプです。
説明、レビュー、アメニティなど、ホテルに関する追加情報を提供します。 |
Content Type |
コンポーネントの種類
番地のコンポーネントを定義します。
要素 |
説明 |
Children |
コンポーネント |
省略可能。 データ型は文字列です。
アドレスの各コンポーネントに component 要素を指定します。
属性:- name - 必須です。 アドレス コンポーネントの名前。 使用可能な値は次のとおりです。
- addr1 - 必須。 ホテルの番地。
- addr2 - 省略可能。 2 番目の番地の住所行。
- addr3 - 省略可能。 3 番目の番地の住所行。
- city - 必須。 ホテルがある都市の名前。
- province - 必須。 ホテルがある州、地域、または都道府県の名前。
- postal_code - 必須。 住所の郵便番号。
|
なし |
コンテンツ タイプ
ホテルに関する追加情報を定義します。 (これらの要素は任意の順序で表示できます)。
要素 |
説明 |
Children |
テキスト |
省略可能。 データ型は Description 型です。
ホテルの説明。
属性: |
説明の種類 |
復習 |
省略可能。 データ型は Review 型です。
ホテルレビュー。 1 つ以上の <review> 要素を指定できます。
属性:- type - 必須。 次のいずれかの型に設定します。
- 編集 - レビューはブロガーまたはその他の専門機関によって書かれています。
- user - レビューはユーザーによって書き込まれます。
|
レビューの種類 |
属性 |
省略可能。 データ型は 属性型です。
ホテルのアメニティの一覧。 含めるアメニティごとに <attr> 子要素を指定します。 |
属性の種類 |
image |
省略可能。 データ型は Image 型です。
ホテルの画像。 1 つ以上の <image> 要素を指定できます。 最適な画像縦横比は 4:3 です。
属性:- type - 必須。 次のいずれかの型に設定します。
- ad — 画像は広告です。
- menu - 画像はホテルのレストランのメニューを示しています。
- 写真 - 画像はホテルの画像です。
- url - 必須。 画像の URL。
- width — 省略可能です。 イメージの幅 (ピクセル単位)。 720 ピクセルを超える必要があります。
- height - 省略可能。 イメージの高さ (ピクセル単位)。 720 ピクセルを超える必要があります。
|
イメージの種類 |
地域 |
省略可能。 データ型は Neighborhood 型です。
ホテルがある地域の一覧。 |
近傍の種類 |
brandCode |
省略可能。 データ型は文字列です。
ロゴに関連付けられているブランド コード。 これは、広告対象のプロパティに複数のロゴがある場合に使用されます。 |
なし |
説明の種類
ホテルの説明を定義します。
要素 |
説明 |
Children |
リンク |
省略可能。 データ型は文字列です。
ホテルのオンライン説明の URL。 |
なし |
title |
省略可能。 データ型は文字列です。
説明に使用するタイトル。 |
なし |
body |
必須です。 データ型は文字列です。
ホテルの説明。 |
なし |
イメージの種類
ホテルのイメージを定義します。
要素 |
説明 |
Children |
date |
必須です。
画像が撮影された日付。
属性:- month - 必須。 画像が撮影された月。 有効な値は 1 (1 月) から 12 (12 月) です
- day - 必須です。 画像が撮影された月の日。
- year - 必須。 画像が撮影された 4 桁の年。
|
なし |
リンク |
省略可能。 データ型は文字列です。
画像を含むホテルの Web ページへの URL。 |
なし |
title |
省略可能。 データ型は文字列です。
イメージに使用するタイトル。 |
なし |
author |
省略可能。 データ型は文字列です。
画像を撮影したユーザーの名前。 |
なし |
近傍の種類
ホテルのある近隣を定義します。
要素 |
説明 |
Children |
近所 |
省略可能。 データ型は文字列です。
ホテルのある地区の名前。 |
なし |
レビューの種類
ホテル レビューを定義します。
要素 |
説明 |
Children |
author |
省略可能。 データ型は文字列です。
レビューを作成したユーザーの名前。 |
なし |
body |
省略可能。 データ型は文字列です。
レビューのテキスト。 テキストには HTML を含めないようにする必要がありますが、含まれる場合はエスケープする必要があります。 |
なし |
date |
省略可能。
レビューが書き込まれた日付。 レビューの種類がユーザーの場合にのみ、日付を指定 します。
属性:- month - 必須。 レビューが書き込まれた月。 有効な値は 1 (1 月) から 12 月 (12 月) です。
- day - 必須です。 レビューが書き込まれた月の日。
- year - 必須。 レビューが書き込まれた 4 桁の年。
|
なし |
リンク |
省略可能。 データ型は文字列です。
オンラインレビューの URL。 |
なし |
格付け |
省略可能。 データ型は文字列です。
レビュー担当者がホテルに与えた評価。 レーティングは、0.0 から 10.0 の範囲の 10 進文字列です。 |
なし |
title |
省略可能。 データ型は文字列です。
レビューのタイトル。 レビューの種類が エディトリアルの場合にのみタイトルを指定します。 |
なし |
属性の種類
ホテルアメニティを定義します。
要素 |
説明 |
Children |
Web サイト |
省略可能。 データ型は文字列です。
ホテルの Web サイトへの URL。 |
なし |
attr |
省略可能。 データ型は文字列です。
ホテルのアメニティ。
属性:- name - 必須です。 次のいずれかの値に設定します。
- air_conditioned - すべての客室にエアコンが備わるかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- all_inclusive_available - 客室料金に食べ物と飲み物が含まれているかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- child_friendly - 客室料金の割引、プレイエリア、キッズクラブなど、お子様と一緒に旅行する家族向けの特別な機能がホテルに含まれているかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_affiliated_golf_course - ホテルの敷地内にゴルフコースがあるか、近くにゴルフコースがあるかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_airport_shuttle - ホテルが無料または有料の空港シャトルを提供するかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_bar_or_lounge - ホテルにアルコール飲料を提供するバーまたはラウンジがあるかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_beach_access - 道路を渡らなくてもホテルがビーチにアクセスできるかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_business_center - ゲストが無料または有料でコンピューターとプリンターを使用できるビジネスセンターがホテルに含まれているかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_fitness_center - ホテルには、敷地内のフィットネスセンターがあります。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_free_breakfast - ホテルが毎日すべてのゲストに無料の朝食を提供するかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_hot_tub - ホテルにホットタブがオンサイトか、一部またはすべての客室にジャグジーまたはジャグジーが含まれているかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_laundry_service - ホテルがゲストの服を洗濯するランドリーサービスを提供するかどうかを示します。 施設内のセルフサービスのコイン式施設はカウントされません。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_restaurant - ホテルに併設レストランがあるかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_room_service - ホテルが館内で料理を用意し、ゲストの部屋に配達するルームサービスを提供するかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- has_spa - ホテルに、マッサージ、フェイシャル、サウナなどのサービスを提供するオンサイト スパがあるかどうかを示します。 必要に応じて、要素の値を [はい] または [いいえ] に設定します。
- kitchen_availability - お部屋に冷蔵庫とコンロ付きのキッチンがあるかどうかを示します。 要素の値を [ すべての部屋で使用可能]、[ 一部の部屋で利用可能]、または [利用できない] に設定します。
- num_reviews - ホテルがレビューされた回数。 要素の値にレビューの数を設定します。
- number_of_rooms - 一覧に関連付けられている単位の数。 要素の値にレビューの数を設定します。
- parking_type - 駐車場が利用可能かどうか、無料かどうかを示します。 要素の値を [支払い不要]、[ 支払い済み]、または [利用できない] に設定します。
- pets_allowed - ペットを同伴できるかどうかを示します。 要素の値を [はい] または [いいえ] に設定します。
- smoke_free_property - ホテルが喫煙を許可するかどうかを示します。 要素の値を [はい] または [いいえ] に設定します。
- star_rating - ホテルのstar評価。 使用可能な値は 1 から 5 です。
- swimming_pool_type - ホテルにゲスト用のスイミングプールがあるかどうかを示します。 要素の値を [屋内]、[屋外]、[屋内と屋外]、[使用できない] に設定します。
- wheelchair_accessible - ホテルが車椅子でアクセスできるかどうかを示します。 要素の値を [はい] または [いいえ] に設定します。
- wifi_type - ホテルが WiFi サービスを提供するかどうかを示します。 要素の値を [支払い不要]、[ 支払い済み]、または [利用できない] に設定します。
- custom_0 - 他の属性には適用できない追加情報のカスタム パラメーター
- custom_1 - 他の属性には適用できない追加情報のカスタム パラメーター
- custom_2 - 他の属性には適用できない追加情報のカスタム パラメーター
- custom_3 - 他の属性には適用できない追加情報のカスタム パラメーター
- custom_4 - 他の属性に適用できない追加情報のカスタム パラメーター
|
なし |