API に無い OTA 設定の出どころを、チャネルマネージャの管理画面から特定する

いつ使うか

「API（または priceRule / レート表）を変えたのに、OTA（Airbnb / Booking.com など）のゲスト表示が 何日待っても変わらない」。しかも API を全部読んでも、その値がどこにも見つからない。 このとき犯しがちな誤りは 「API に無い＝OTA 側が保持していて、こちらからは変えられない」 と結論すること。 実際には チャネルマネージャの管理画面にだけ在る、API 非公開の『チャネル固有コンテンツ』欄が その値を握っていることがある。追加人数料金・基本人数・最小泊数・チェックイン時刻などが該当しやすい。

この手順は「触っていた欄が最初から違った」という数日規模の空振りを防ぐためのもの。

大原則: 3層を分けて読む

1. API 層（/properties /rates /priceRules など）… プログラムから読める値
2. チャネル固有コンテンツ層（管理画面の「OTA > 各チャネル > 特定コンテンツ / room content」） … API に出ないことがある。OTA ごとに別ページ・別フィールド
3. OTA 実表示層（ゲストが見る公開ページの総額）… 最終的な事実

「API に無い」で止めず、必ず 2 を読む。2 と 3 が一致していれば出どころは 2 で確定する。

手順

1. まず API を全数走査して「無い」を確定する（取得漏れと切り分ける）

対象の金額・値を、ペイロード全体を歩いて全一致検索する。priceRule だけを見ない （別フィールドや別チャネル設定に入っていることがある）。

• 応答が途中で切れていないか先に確認する（応答長・次ページフラグ・想定件数）。 「取れていない」を「空だった」と誤読すると、この後の全部が狂う。
• 0件なら「API には無い ＝ 出どころは管理画面のチャネル固有設定」に候補を絞れる。

2. 管理画面に生ログインセッションで接続して読む（書かない）

• 常駐ブラウザ（CDP 接続）にログイン済みセッションを用意し、読み取り専用で管理画面を開く。
• 死活は「認証必須ページの中身」で判定する。トップの部品有無や本文長で判定しない （描画済みでも未ログイン、その逆もある）。ログインフォーム要素の有無で見るのが確実。

3. 設定トップの「リンク一覧」から正しい pagetype/URL を拾う（URL を推測しない）

• チャネル設定ページのリンク文字列とURLの対応表を丸ごと取得し、目的のチャネル名で絞り込む。
• 推測 URL で開くと、黙ってダッシュボードにリダイレクトされることがある。 そのときログインフォームは出ないので「読めた」と誤認しやすい。 → 開いた後の最終 URL を必ず読み、想定 pagetype のままか確認する。ダッシュボードに戻されていたら失敗。

4. 入力欄の「値」を読む（innerText では出ない）

• 設定値は多くが <input> / <select> の value に入っており、ページの表示テキストには出ない。
• <input value> と <select> の選択中 option を列挙して読む。ここに探していた値が居る。
• OTA によっては「送信内容の確認（view）ページ」があり、**各値の出典つきで 『自分が OTA に何を送っているか』**を一覧してくれる。これが取れれば 2層＝3層 の確定証拠になる。

5. 部屋ごと・チャネルごとに独立して読む

• 同じ設定でも部屋（room）ごとに別の値が入っていることがある（例: 基本人数が部屋Aは2・部屋Bは空）。 代表1部屋だけ見て「全部同じ」と決めない。URL に room 識別子を付けて1部屋ずつ読む。
• 「2部屋の priceRule が同一なのに OTA 表示が違う ＝ OTA 側の残留」と早合点しない。 チャネル固有コンテンツ層の値が部屋ごとに違うのが原因のことがある。

変更するときの鉄則

• 出どころが「チャネル固有コンテンツ欄」だと分かっても、API/priceRule を変えても効かない （制御している層が違う）。変えるのはその欄そのもの。多くは管理画面のフォーム編集になる。
• 1部屋だけ先に変えて、OTA 実表示に伝播するか確かめてから横展開する。 一括で全部屋を変えると、伝播しなかったときに原因を追えなくなる。伝播は即時でないことが多い。
• 変更の確認は設定画面の値ではなく、ゲストが見る公開ページの総額から逆算する。

一言で

API に無い＝手が出せない、ではない。チャネルマネージャの「OTA別・部屋別のコンテンツ欄」を、 生セッションで・入力欄の value を・リダイレクトを警戒しながら読む。 そこに答えがあることが多い。