チャンネル内の新しいビデオ（トリガー）
このピースでできることYouTubeの接続方法1. 接続を作成2. Google Cloud Projectの作成3. YouTube Data APIの有効化4. OAuth同意画面の設定5. workrun側での設定ピースの設定項目1. チャンネル（必須）動作のポイント参考情報入力例のバリエーション取得できる情報出力例（抜粋）
このピースでできること
- 指定したYouTubeチャンネルのRSSで、前回確認した動画IDの一覧に含まれない動画を検知するとワークフローを起動します。
- 認証不要で利用でき、RSS フィードを用いるため API クォータを消費しません。
YouTubeの接続方法
1. 接続を作成
- 接続から「接続を作成」をクリックします。
2. Google Cloud Projectの作成
- Google Cloud Consoleにサインインします。
- 新しいプロジェクトを作成するか、既存のプロジェクトを使用します。以下では新しいプロジェクトを作成する場合の手順を示します。左上のプロジェクトウィンドウをクリックします。
- 右上の「新しいプロジェクト」をクリックします。
- プロジェクト名を入力して「作成」ボタンを押して作成完了です。
3. YouTube Data APIの有効化
- 左上のハンバーガーメニューから「APIとサービス」>「有効なAPIとサービス」を押します。
- 検索バーで「YouTube Data API」を検索し、有効にします。
4. OAuth同意画面の設定
- サイドバーの「OAuth同意画面」をクリックし「作成」をクリックします。
- 必要事項を入力していきます。対象は「外部」を選択します。
- サイドバーの「データアクセス」クリックし、「スコープの追加または削除」をクリックします。スコープ追加画面では指定のスコープを追加して「更新」をクリックします。
- サイドバーの「対象」をクリックし、「Add Users」ボタンをクリックします。テストメールを追加します(自分のメールアドレスを追加できます)。その後、「保存」をクリックします。
- サイドバーの「クライアント」へ移動します。「クライアントを作成」をクリックします。必要事項を入力してAuthorized redirect URIsフィールドに「https://ap.b-work.run/redirect」を追加し、「作成」ボタンをクリックします。
- クライアント IDとクライアントシークレットをコピーします。
5. workrun側での設定
- workrunのYouTubeに接続の画面で10でコピーしたクライアントIDとクライアントシークレーとを入力し、「接続する」ボタンを押します。
- Googleの各種認証を行って「保存」ボタンを押します。
- 「保存」ボタンを押して、設定名が正しく保存されているかを確認します。
ピースの設定項目
1. チャンネル（必須）
- 監視対象のチャンネルを ID、チャンネル URL、または @から始まるハンドルで指定します。
- いずれの形式でも内部でチャンネル ID に解決されます。
動作のポイント
- ポーリング方式でRSSを確認し、主に動画のを使って前回取得した動画IDとの差分を判定します。
- RSSの取得結果や掲載順によって検知内容が異なることがあります。削除・再作成のあらゆるケースを保証するものではありません。
- 同じの動画でタイトル・説明・サムネイルやだけが変更されても、それだけでは再通知されません。
参考情報
- RSS フィード URL 形式: https://www.youtube.com/feeds/videos.xml?channel_id={channelId}
入力例のバリエーション
- チャンネル URL で指定する例
- ハンドルで指定する例
取得できる情報
指定したYouTubeチャンネルのRSSフィードから、新しく検知した動画について、動画情報を1件ずつ後続ステップに渡します。
| 実際のキー | 内容・条件 |
|---|---|
| / / / | 動画タイトル、動画URL、フィード内の識別子、投稿者名 |
| / / | 公開日時など、RSSの解析で得られる日時情報。キーや値はフィードに依存します |
| サムネイルURL（RSSの解析結果に含まれる場合） | |
| / | YouTube固有のRSS項目。実際のオブジェクトの階層や含まれる項目はテスト結果で確認してください |
| RSSフィード全体のメタ情報（提供される場合） |
- 現行の検知処理は主にの差分を使います。同じ動画IDでメタデータだけが変わった場合、更新イベントとして必ず再通知するものではありません。
- テストでは現在のフィードから最大5件を取得します。RSSの取得に失敗した場合は出力を確認できません。動画や画像のメディアファイル本体を取得するものではありません。
- やなどを後続ステップの新着動画案内に使用できます。RSS由来の項目は変動するため、実際のキーと階層はテストトリガーで確認してください。
出力例（抜粋）
取得項目を説明するための架空例です。