サイト公告
保存済みアカウントに紐づくサイトの公告を自動取得し、新しい公告をプラグイン内に集約して、必要に応じてタスク通知で知らせます。
どんな場面で使うか
多くの中継サイトでは、メンテナンス予定、モデル変更、価格調整、チャージキャンペーン、利用制限などをサイト公告で知らせます。複数のアカウントを管理している場合、各サイトを個別に開いて確認すると見落としやすくなります。
サイト公告機能は、有効なアカウントに紐づくサイトをバックグラウンドで定期的に確認し、新しい公告を サイト公告 ページにまとめます。このページでは、サイトでの絞り込み、公告内容の確認、既読化、手動チェックができます。
通知との関係
サイト公告は 公告の取得、保存、表示 を担当します。タスク通知は、新しい公告が見つかったあとに、ブラウザシステム通知やサードパーティチャネルへ通知を送るだけです。
そのため、次の 2 つのスイッチは別々に動作します。
サイト公告ポーリングを有効化:バックグラウンドでサイト公告を定期チェックするかを制御します。サイト公告通知:新しい公告をタスク通知チャネルで送信するかを制御します。
公告をまとめて確認したいだけでポップアップ通知が不要な場合は、取得を有効にして通知を無効にできます。取得を無効にすると、通知チャネルだけでサイト公告を読み取りに行くことはありません。
入口
公告を確認する
- All API Hub の設定ページを開きます。
- 左側メニューで
サイト公告を開きます。 - 取得済みの公告記録を確認するか、
今すぐチェックをクリックして手動更新します。
バックグラウンド取得を有効化または無効化する
基本設定 → 一般を開きます。サイト公告を探します。サイト公告ポーリングを有効化でバックグラウンドの定期チェックを切り替えます。
バックグラウンド取得を無効にしても、保存済みのローカル公告記録は削除されません。サイト公告 ページでは引き続き手動チェックできます。
新しい公告の通知を設定する
サイト公告の通知は、タスク通知 で設定した通知チャネルを使います。
基本設定 → 一般 → 通知を開きます。タスク通知を有効化をオンにし、少なくとも 1 つの通知チャネルを設定します。- 通知イベントで
サイト公告通知を有効にします。
サイト公告通知 だけを無効にした場合、新しい公告はローカルには保存されますが、ブラウザ通知やサードパーティチャネルには送信されません。
取得ルール
| 項目 | 説明 |
|---|---|
| チェック対象 | 保存済みで有効なアカウント。 |
| デフォルト間隔 | デフォルトでは 360 分ごとにチェックします。 |
| 間隔の範囲 | 設定値は 15 分から 24 時間の範囲に制限されます。 |
| 重複排除 | 同じサイトの新しい公告は、内容または上流の公告 ID で重複排除されます。 |
| ローカル保持 | 1 サイトあたり最大 10 件の公告記録を保持します。 |
| 手動チェック | サイト公告 ページの 今すぐチェック は、バックグラウンド取得スイッチの影響を受けません。 |
同じサイト全体の公告エンドポイントを共有するアカウントについては、同じサイトを重複して取得しないように 1 回だけチェックします。Sub2API の公告はアカウント単位の未読公告なので、アカウントごとにチェックします。
対応範囲
サイト公告は現在、主に次の 2 種類の取得元に対応しています。
| 取得元 | 取得方法 | 説明 |
|---|---|---|
| One API / New API 互換サイトと一般的な派生版 | サイトの /api/notice 公告エンドポイントを読み取ります | 多くの One API、New API、Veloera、OneHub、DoneHub などの互換デプロイで利用できます。実際に使えるかは、対象サイトがこのエンドポイントを残しており、利用可能な公告内容を返すかに依存します。 |
| Sub2API | アカウントの未読公告エンドポイントを読み取ります | 未読公告を取得したあと、通知成功時またはローカルでの閲覧時に、上流の既読状態をできるだけ同期します。 |
サイトに利用可能な公告エンドポイントがない場合や、エンドポイントが空の内容を返す場合、All API Hub は表示できる公告がないものとして扱います。サイト公告 ページで、サイトごとの直近チェック状態を確認できます。
ページでできること
サイト公告 ページでは次の操作ができます。
- 集計指標:公告総数、未読公告数、対象サイト数を確認します。
- 絞り込み:サイト、サイト種別、既読状態で絞り込みます。
- 内容を展開:単一の公告を開いて全文を確認します。
- 既読にする:単一の公告、または現在の絞り込み範囲の公告を既読にします。
- 今すぐチェック:手動で公告取得を実行し、ローカル記録を更新します。
- 取得元を開く:対応するサイトの公告ページまたはホームページを開き、元サイトで詳細を確認します。
よくある質問
公告記録が何も表示されないのはなぜですか?
考えられる原因は次のとおりです。
- 対象アカウントのサイトに現在公告がない。
- サイトが互換性のある公告エンドポイントを公開していない。
- アカウントが無効化されているため、バックグラウンドチェックの対象外になっている。
- ブラウザのバックグラウンドタスクがまだ実行されていない。
サイト公告を開いて今すぐチェックをクリックしてください。
「対応する公告エンドポイントがない」と表示されるのはなぜですか?
直近のチェックで利用可能な公告エンドポイントが見つからなかった、または対象サイトの API 挙動が All API Hub の現在対応している形式と一致しなかったことを示します。独自改修されたデプロイ、公告エンドポイントを無効化したサイト、レスポンス形式が変わったサイトでよく起こります。
通知を無効にしても新しい公告が見えるのはなぜですか?
サイト公告通知 は、新しい公告をブラウザシステム通知やサードパーティチャネルへ送信するかだけを制御します。サイト公告ポーリングを有効化 がオンのままであれば、新しい公告は引き続きローカルに保存されます。
バックグラウンド取得を無効にしても手動チェックできるのはなぜですか?
バックグラウンド取得スイッチは定期タスクだけを制御します。手動チェックは一時的な更新やトラブルシューティングのためにユーザーが明示的に実行する操作なので、このスイッチではブロックされません。
Sub2API の既読状態はサイト側にも同期されますか?
可能な範囲で同期されます。新しい公告の通知に成功したあと、対応する Sub2API 公告を既読にするよう試みます。ローカルで未読の Sub2API 公告を展開した場合も、上流の既読状態を同期しようとします。サイト API が失敗した場合でも、ローカルの既読状態はユーザー操作に従って更新されます。
関連ドキュメント
- タスク通知:ブラウザシステム通知、Telegram、Feishu、DingTalk、WeCom、ntfy、汎用 Webhook を設定します。
- アカウント管理:公告取得の対象にするアカウントの追加、無効化、整理を行います。
- 対応サイトとシステム種別:一般的なサイト種別と互換範囲を確認します。
