移除廣告空間
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
如果某個房源或行程組合無法使用,你可以透過交易訊息移除該組合。通常在飯店某個特定晚或一系列晚已預訂一空時,才會使用這個選項。
使用交易訊息移除廣告空間
如要從商品目錄中移除特定房源或行程,請在根元素 <Transaction>
中使用交易訊息。
在交易訊息中,針對 <Result>
元素中要移除的每個行程,指定下列設定:
- 使用原因子元素 (例如
<NoVacancy>
) 設定 <Unavailable>
。
- 將
<Taxes>
設為「0」
- 將
<OtherFees>
設為「0」
選用:將 <Baserate>
設為「-1」
以下範例會移除多個行程,例如從商品目錄中移除飯店「1123581321」的多個 1 晚住宿:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-05-23T16:20:00-04:00" id="42">
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-23</Checkin>
<Nights>1</Nights>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-24</Checkin>
<Nights>1</Nights>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
<!---Sending <Baserate> is optional with <Unavailable> -->
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-25</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">-1</Baserate>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
</Transaction>
如這個範例所示,您必須明確設定 <Unavailable>
,並提供每個行程 (入住日期和住宿天數的組合) 無法提供房間的原因。此外,您必須將 <Taxes>
和 <OtherFees>
設為 0。您可以選擇是否將 <Baserate>
設為 -1。
如要移除 Room Bundle,請從 <Result>
中刪除 <RoomBundle>
元素。
詳情請參閱「移除 Room Bundle」。
保留所有權利。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eUse Transaction messages to remove specific property or itinerary combinations from hotel inventory, typically when fully booked.\u003c/p\u003e\n"],["\u003cp\u003eWithin the Transaction message's \u003ccode\u003e<Result>\u003c/code\u003e element, indicate unavailability using \u003ccode\u003e<Unavailable>\u003c/code\u003e with a reason code (e.g., \u003ccode\u003e<NoVacancy>\u003c/code\u003e), set \u003ccode\u003e<Taxes>\u003c/code\u003e and \u003ccode\u003e<OtherFees>\u003c/code\u003e to 0, and optionally set \u003ccode\u003e<Baserate>\u003c/code\u003e to -1.\u003c/p\u003e\n"],["\u003cp\u003eEach unavailable itinerary (check-in date and number of nights) requires its own \u003ccode\u003e<Result>\u003c/code\u003e element within the Transaction message.\u003c/p\u003e\n"],["\u003cp\u003eTo remove a Room Bundle, simply delete the corresponding \u003ccode\u003e<RoomBundle>\u003c/code\u003e element from the \u003ccode\u003e<Result>\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Remove inventory\n\nIf a property or itinerary combination is unavailable, you can remove it with a\n[Transaction message](/hotels/hotel-prices/dev-guide/transaction-overview).\nYou typically use this option when a hotel is fully booked for a given night\nor series of nights.\n\nRemove inventory with a Transaction message\n-------------------------------------------\n\nTo remove specific property or itineraries from inventory, use a Transaction\nmessage in the root element [`\u003cTransaction\u003e`](../xml-reference/transaction-messages#Transaction).\n\nIn the Transaction message, specify the following settings for each itinerary\nyou want to remove in the `\u003cResult\u003e` element:\n\n1. Set `\u003cUnavailable\u003e` with the reason child element, for example,`\u003cNoVacancy\u003e`.\n2. Set `\u003cTaxes\u003e` to \"0\"\n3. Set `\u003cOtherFees\u003e` to \"0\"\n\n**Optional:** Set `\u003cBaserate\u003e` to \"-1\"\n\nThe following example removes several itineraries, for example, remove 1-night\nstays for several different dates for hotel \"1123581321\" from inventory: \n\n \u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n \u003cTransaction timestamp=\"2023-05-23T16:20:00-04:00\" id=\"42\"\u003e\n \u003cResult\u003e\n \u003cProperty\u003e1123581321\u003c/Property\u003e\n \u003cCheckin\u003e2023-05-23\u003c/Checkin\u003e\n \u003cNights\u003e1\u003c/Nights\u003e\n \u003cUnavailable\u003e\n \u003cNoVacancy/\u003e\n \u003c/Unavailable\u003e\n \u003cTax currency=\"USD\"\u003e0\u003c/Tax\u003e\n \u003cOtherFees currency=\"USD\"\u003e0\u003c/OtherFees\u003e\n \u003c/Result\u003e\n \u003cResult\u003e\n \u003cProperty\u003e1123581321\u003c/Property\u003e\n \u003cCheckin\u003e2023-05-24\u003c/Checkin\u003e\n \u003cNights\u003e1\u003c/Nights\u003e\n \u003cUnavailable\u003e\n \u003cNoVacancy/\u003e\n \u003c/Unavailable\u003e\n \u003cTax currency=\"USD\"\u003e0\u003c/Tax\u003e\n \u003cOtherFees currency=\"USD\"\u003e0\u003c/OtherFees\u003e\n \u003c/Result\u003e\n \u003c!---Sending \u003cBaserate\u003e is optional with \u003cUnavailable\u003e --\u003e\n \u003cResult\u003e\n \u003cProperty\u003e1123581321\u003c/Property\u003e\n \u003cCheckin\u003e2023-05-25\u003c/Checkin\u003e\n \u003cNights\u003e1\u003c/Nights\u003e\n \u003cBaserate currency=\"USD\"\u003e-1\u003c/Baserate\u003e\n \u003cUnavailable\u003e\n \u003cNoVacancy/\u003e\n \u003c/Unavailable\u003e\n \u003cTax currency=\"USD\"\u003e0\u003c/Tax\u003e\n \u003cOtherFees currency=\"USD\"\u003e0\u003c/OtherFees\u003e\n \u003c/Result\u003e\n \u003c/Transaction\u003e\n\nAs this example shows, you must explicitly set the `\u003cUnavailable\u003e` with the\nreason for *each itinerary* (combinations of check-in dates and number of\nnights) for which the room is unavailable. In addition, you must set the\n`\u003cTaxes\u003e` and `\u003cOtherFees\u003e` to 0. Setting `\u003cBaserate\u003e` to -1 is optional.\n\nTo remove a Room Bundle, delete the `\u003cRoomBundle\u003e` element from the\n`\u003cResult\u003e`.\n\nFor more information, see\n[Room Bundle removal](/hotels/hotel-prices/dev-guide/room-bundles#removing)."]]