> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube 通知

> 新しい YouTube のアップロードとライブ配信を Discord サーバーで告知します。

<Info>
  **Basic** が必要。サーバーごとに最大 **10 チャンネル**。共通ルールは [通知の仕組み](/ja/notifications/overview) を参照。
</Info>

## チャンネルの追加

チャンネル名で検索します。Vetox がチャンネル ID に解決し、解決できないチャンネルは **YouTube channel not found** で拒否されます。

## 設定

| 設定                            | 既定         | 備考    |
| ----------------------------- | ---------- | ----- |
| **Discord Channel**           | —          | 必須    |
| **Notify on upload**          | **オン**     | 新規動画  |
| **Notify on live**            | **オン**     | ライブ配信 |
| **Mention Role**              | なし         |       |
| **Custom Notification Embed** | YouTube 既定 | 赤     |

<Warning>
  **両方** のトグルをオフにしても文句なく保存され、そのチャンネルは何も告知しないことになります。この状態への警告はありません。
</Warning>

## 変数

| 変数                  | 解決先           |
| ------------------- | ------------- |
| `{channel.name}`    | チャンネル名        |
| `{channel.avatar}`  | チャンネルアバター     |
| `{video.title}`     | 動画タイトル        |
| `{video.url}`       | 動画 URL        |
| `{video.thumbnail}` | 動画サムネイル       |
| `{video.type}`      | アップロードかライブ配信か |

## 新着の探し方

**5 分ごと** に確認、チャンネルごとに **10 分のクールダウン**。Vetox はチャンネルのフィードを読み、毎回 **直近 5 件** のエントリを候補にします。

<Note>
  5 分間で 5 本を超える動画を公開するチャンネルでは、最古のものが取り逃されることがあります。
</Note>

<Warning>
  **予約プレミアはアップロード扱いで告知され**、ライブ用ではなくアップロード用の文言が使われます。埋め込みに「配信開始」と書いていると、プレミアで違和感が出ます。
</Warning>

## 実運用のセットアップ

<Steps>
  <Step title="サーバーセットアップで YouTube をオン" />

  <Step title="名前でチャンネルを追加" />

  <Step title="文言を分けたい場合はアップロードとライブを分離">
    同じ YouTube チャンネルのアップロードとライブを別々の Discord チャンネルにルーティングすることはできません — エントリごとに 1 チャンネル。代わりに `{video.type}` を埋め込みで使って区別してください。
  </Step>

  <Step title="対象チャンネルの Embed Links を確認" />
</Steps>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="新しい動画が告知されない">
    まずサーバーセットアップのトグルとプレミアム。次に 2 つの通知トグルのうち少なくとも 1 つがオンか確認。動画が 2 時間以上前ならスキップされます。
  </Accordion>

  <Accordion title="プレミアが通常アップロードとして告知された">
    仕様 — プレミアはアップロードに分類されます。
  </Accordion>

  <Accordion title="ショート動画も告知されるが要らない">
    Shorts を除外するフィルタはありません。チャンネルのフィード上のすべてが同等に扱われます。
  </Accordion>

  <Accordion title="告知が最大 5 分遅れる">
    それがポーリング間隔です。YouTube は 5 分ごとに確認され、即時ではありません。
  </Accordion>
</AccordionGroup>

<Card title="Twitch" icon="twitch" horizontal href="/ja/notifications/twitch">
  即時状態追跡のライブ配信。
</Card>