在先前的 Hotel 摘要) 檔案 (建立 XML 屬性摘要
注意事項
自 4 月 9 日起，您將無法再擁有飯店中心的完整存取權。 我們期待將您介紹至屬性中心，這會提供令人興奮的自助功能。 感謝您在使用新功能更新說明內容時，耐心等候。 在此同時，您可以 閱讀這些即將進行的變更，以及如何讓移轉程式更順暢。
若要提供Microsoft旅館清單，請建立 XML 檔，其中包含您想要公告的每個旅館清單。 清單描述旅館的名稱、位址、電話號碼、地理座標、設施等等。
文件必須使用UTF-8編碼，而且必須符合 Hotel XSD。
如需使用 CSV 或 TSV 檔案格式建立摘要檔案的相關信息，請參閱 建立 CSV 屬性摘要檔案。
注意事項
Microsoft不支援所有 XSD 元素。 Microsoft會忽略檔中不支援的任何項目或屬性。 屬性摘要參考只包含Microsoft支援的元素和屬性。
注意事項
文件必須以 Hotel XSD (中定義的順序指定專案，如參考) 所示。
取得正確的數據
因為Microsoft嘗試比對您屬性摘要中的屬性與 Bing 地圖服務中的企業，所以您提供有關旅館的數據必須正確且完整。
如果旅館有遺漏或不正確的資訊，Microsoft可能無法比對。 如果Microsoft無法與旅館相符，Microsoft將不會公告。 您將能夠在旅館中心檢視比對報告，指出哪些旅館Microsoft相符或不相符。 如果Microsoft不符合旅館，報表會包含訊息「無法將此旅館與 Bing 中的屬性比對。 如需改善比對率的協助，請確定它們可在商務用 Bing 地點中使用。
摘要中的最上層元素
屬性摘要包含單一的最上層 清單 專案。 元素listings包含兩個必要的子專案：和 listing。 language
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<language>en</language>
<listing>
. . .
</listing>
...
</listings>
注意事項
我們目前僅支援英文摘要數據。
元素 language 會指定要寫入摘要中數據的語言。 若要指定語言，請使用兩個字母的 ISO 639 語言代碼。 例如，將 en 用於英文。
清單元素包含旅館的相關信息，例如其名稱、地址和電話號碼。 如需定義清單的相關信息，請參閱 定義旅館清單。
定義旅館清單
元素 listing 會定義旅館。 您必須為每個通告的旅館指定 listing 元素。 下列範例顯示您必須為清單指定的最小元素。 例外狀況是您可以指定地理座標或電話號碼。 雖然您可以指定座標或電話號碼，但您應該同時指定兩者，以確保在 Bing 地圖服務中比對屬性的機會更好。
<listing>
<id>abc123</id>
<name>Great Ambers Getaway</name>
<address>
<component name="addr1">1234 Porter Road</component>
<component name="city">Goldendale</component>
<component name="province">WA</component>
<component name="postal_code">98234</component>
</address>
<country>US</country>
<latitude>47.694351</latitude>
<longitude>-122.451782</longitude>
<phone type="main">123-456-7890</phone>
</listing>
元素中的 id 標識碼是用戶定義的，而且在摘要內必須是唯一的。
元素中的 address 位址是旅館的街地道址。 地址必須是街地道址，而不是郵局方塊。 您可以使用 component 上述範例中所見的 元素，或使用下列範例中所示的自由格式字串來指定旅館的位址。 喜好設定是使用 component 專案。
<address>1234 Porter Road, Goldendale, WA, 98234</address>
和 latitudelongitude 元素會指定旅館的地理座標。 使用地理編碼 API，例如位置 API ，從街地道址產生座標。
清單至少必須指定旅館的主要電話號碼。 主要號碼應該是前台的電話號碼，而不是中央保留的電話號碼。 您提供的連絡電話號碼越多越好。 下列範例顯示其他電話選項。
<phone type="main">123-456-7890</phone>
<phone type="tollfree">800-456-7890</phone>
<phone type="fax">123-456-7890</phone>
<phone type="tdd">123-456-7890</phone>
<phone type="mobile">123-456-7890</phone>
如需指定電話號碼的詳細資訊，請參閱 電話 元素。
指定選擇性旅館清單欄位
下列範例顯示您可以包含在清單中的選擇性元素。 雖然是選擇性的，但您應該盡可能包含更多資訊，以支援目前和未來的使用案例。
<listing>
. . .
<category>hotel | inn</category>
<content>
<text type="description">
<body>This element contains the hotel's description.</body>
</text>
<review type="user">
<body>This element contains a review of the hotel.</body>
<date month="2" day="24" year="2018" />
<link>https://contoso.com/reviews/hotels?id=sd87s90</link>
<rating>8.5</rating>
</review>
<attributes>
<website>https://contoso.com</website>
<attr name="air_conditioned">Yes</attr>
<attr name="has_airport_shuttle">Yes</attr>
<attr name="parking_type">No payment required</attr>
</attributes>
<image type="photo" url="https://contoso.com/photos?id=345k43llj" width=800 height=600>
<date month="3" day="3" year="2018" />
<link>https://contoso.com/...</link>
<title>Hotel entrance</title>
</image>
<neighborhoods>
<neighborhood>Sodo District</neighborhood>
</neighborhoods>
<brand>Contoso</brand>
</content>
</listing>
預期 category 的元素格式 是vacation_rental 或 旅館 ，後面接著管道字元和自定義值。 例如， vacation_rental |'custom value' 或 hotel |'custom value'
如需自定義值的清單，請參閱 Lodging 屬性類別目錄。
元素 text 包含旅館的描述。 您必須指定 body 包含實際描述的專案。 視描述的長度而定，它可能會在顯示時截斷。 如果您包含 link 和 title 元素，連結 URL 會指向在線描述。
元素 review 包含用戶評論或編輯檢閱。 編輯檢閱是由檢閱機構所完成的專業檢閱，例如旅遊旅行家。 您可以包含任意數量的評論，但視傳送的評論數目而定，可能不會全部顯示。 您必須指定 body 包含檢閱的專案。 視檢閱的長度而定，它可能會在顯示時截斷。 如果您包含 元素 link ，它會指向在線評論的完整清單。
元素 attributes 包含旅館提供的設施清單，例如空調、水池和免費的旅館。 如需可能的設施清單，請參閱 屬性。 如果您未指定設施，則會假設旅館未提供該設施。
元素 image 包含旅館的影像。 您可以包含任意數目的影像，但視傳送的影像數目而定，可能不會全部顯示。 建議的外觀配置為 4：3，且最小寬度為 720 圖元。 影像必須是原始相片，而且不能是螢幕快照。 請注意， link AdIdxBot 編目程式必須可存取 URL。 如果您的網站包含 robots.txt 檔案，它必須包含下列其中一個：
- User-Agent：AdIdxBot
- 允許：/
元素 neighborhood 會識別旅館所在的鄰近地區。 如果旅館位於數個鄰近地區之間，您可以指定多個鄰近地區。
元素 brand 會識別旅館的品牌。 例如，Fabrikam Marketplaces by Contoso，其中 Contoso 是品牌。
如果旅館的內容變更，會發生什麼事？
如果您在摘要執行之間變更任何旅館的屬性值， (例如其名稱、位址、電話等 ) ，Microsoft Advertising 可能會將它視為新的旅館屬性，併為其建立新的清單。 如果Microsoft建立新清單，舊旅館的先前效能歷程記錄會保留最多 36 個月。 請注意，舊旅館的報價和乘數將不會轉移至新的旅館實體。
如果您移除旅館，並以與之前相同的屬性值將其新增至稍後的摘要中，Microsoft將它視為新的清單。 此外，效能報告會將其顯示為兩個不同的清單。
一般規則
在將屬性摘要檔案傳送至 Microsoft 之前，請使用 Hotel XSD 來驗證屬性摘要檔案。
屬性摘要文件必須使用UTF-8編碼。
摘要必須包含您所有旅館的清單，摘要程式不支援部分更新。
Microsoft會忽略它不支援的任何項目或屬性。
元素必須是以 Hotel XSD 中指定的順序。
如果您的數據包含像是單引號或引號等特殊字元，請將其逸出或使用 CDATA 區段。 如果您逸出它們，您可以使用實體代碼或字元代碼。 例如，您可以將Paul的逸出為paul's 或 Paul's.
請勿包含不包含資料的專案。 例如，如果您未提供旅館的地理座標，請勿包含空 <的緯度> 和 <經度> 元素。
請勿在 XML 元素中使用 HTML。
後續步驟
建立摘要檔案之後，請使用 Hotel XSD 進行驗證。
要求您的帳戶管理員匯入摘要檔案。
也請務必匯入登陸頁面數據。 如需建立登陸頁面摘要檔案的相關信息，請參閱 登陸頁面摘要。
在Microsoft成功匯入您的數據，並且能夠比對您的飯店與 Bing 地圖服務中的屬性之後，您就可以開始傳送旅館價格和可用性數據。 如需詳細資訊，請 參閱價格摘要。