広告枠を削除
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
宿泊施設と旅行プランの組み合わせを提供できない場合は、Transaction メッセージで削除できます。通常、このオプションは、特定の宿泊日または一連の宿泊日でホテルの全室が予約されている場合に使用します。
Transaction メッセージを使って広告枠を削除する
広告枠から特定の宿泊施設や旅行プランを削除するには、ルート要素 <Transaction>
でトランザクション メッセージを使用します。
トランザクション メッセージの <Result>
要素で、削除する旅行プランごとに次の設定を指定します。
<Unavailable>
を理由の子要素(例: <NoVacancy>
)で設定します。
<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 に設定するのは任意です。
条件の組み合わせを削除するには、<Result>
から <RoomBundle>
要素を削除します。
詳しくは、条件の組み合わせの削除をご覧ください。
All rights reserved. Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\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)."]]