YouTube Data API v3 × GAS × Geminiで実現！再生リストの自動並び替えツールを自作する全手順

YouTubeの再生リスト、動画が増えれば増えるほど「並び替え」が苦行になりますよね。100曲、200曲あるアニソンリストを「作品順」や「放送時期順」に整理したいけれど、手動はあまりにも大変過ぎます……。

そこで、Google Apps Script (GAS) と AI（Gemini）を組み合わせて、再生リストを爆速で整理する「最強の管理ツール」を開発しました。実際に運用して成功した操作手順を完全公開します！

ツールの全体構成

単にプログラムでYouTubeを操作するだけでなく、「AIの得意なこと（並び替えの考案）」と「スプレッドシートの得意なこと（正確なデータの紐付け）」を役割分担させているのが最大の特徴です。

役割

• YouTube Data API v3：YouTube上の再生リストを操作するための窓口
• Google Apps Script (GAS)：全体の司令塔。APIを叩き、取得したデータをスプレッドシートへ出力
• Googleスプレッドシート：データの保管庫兼ユーザーインターフェース。
• Gemini (AI)：並び替え案のロジック担当。曖昧な要望でも上手くとらえて、最適な順序を計算できる可能性がある。

ツールの全体構成図

本記事の前提条件

• Google AI Plusプラン以上：GoogleスプレッドシートのGemini関数を利用する想定のため

※ただし、Gemini関数を使わなくてもツール自体は利用できます。

ツール操作の5ステップ

ツールの導入から反映までの全手順を、実際の画面と共に説明します。

今回は私が普段よく聞いている以下のアニソン再生リストをいい感じに並べ替えてみたいと思います。

【STEP 1】YouTube APIの有効化とセットアップ

まずは、Googleスプレッドシートの「拡張機能」→「Apps Script」を開きます。

Apps Scriptの画面で、サービスの「＋」を選択します。

サービスを追加画面で「YouTube Data API v3」を追加し、IDは「YouTubePlayListControl」とします。デフォルトのIDでも問題ありませんが、その場合は次のコードでサービス名の設定をそのIDに変更してください。

追加したら、コード.gsに以下のようにコードを貼り付けて保存します。

貼り付けるコードは以下です。

一番上の'ここに再生リストのIDを入力'の部分にあなたが並べ替えしたい再生リストのIDに置き換えてください。

また、今回はアニソンをシリーズごとに固めて並び替えしたいので、92行目でシーズンを出してもらうようなプロンプトにしてますが、他の条件で並び替えをしたい場合はこの92行目のGeminiプロンプトを変更すると良いです。

1. /**
2.  * 【設定】並び替え・管理したい再生リストのID
3.  */
4. const PLAYLIST_ID = 'ここに再生リストのIDを入力';
6. /**
7.  * サービス名の設定
8.  */
9. const YT = YouTubePlayListControl;
11. /**
12.  * カスタムメニューの作成
13.  */
14. function onOpen() {
15.   const ui = SpreadsheetApp.getUi();
16.   ui.createMenu('YouTubeツール')
17.     .addItem('⚠️ 初回セットアップ実行', 'setupTool')
18.     .addSeparator()
19.     .addItem('1. リストを取得（数式準備込）', 'fetchPlaylistVideos')
20.     .addItem('2. 削除・非表示動画をリストから一掃', 'purgeInvalidVideos')
21.     .addItem('3. 並べ替え後シートの順序をYouTubeに反映', 'applyNewOrder')
22.     .addSeparator()
23.     .addItem('📊 ログを手動でリセット', 'resetQuotaLog')
24.     .addToUi();
25. }
27. /**
28.  * ⚠️ 初回セットアップ実行
29.  */
30. function setupTool() {
31.   const ss = SpreadsheetApp.getActiveSpreadsheet();
32.   
33.   const sheets = [
34.     { name: '再生リスト取得', headers: ['現在の順序(0始)', '動画タイトル', '動画ID', 'アニメシリーズ＋シーズン', 'PlaylistItemID', 'ステータス', '存在チェック'] },
35.     { name: '並べ替え後', headers: ['現在の順序(0始)', '動画タイトル', '動画ID', 'アニメシリーズ＋シーズン', 'PlaylistItemID', 'ステータス', '並べ替え後の順序'] }
36.   ];
38.   sheets.forEach(s => {
39.     let sheet = ss.getSheetByName(s.name) || ss.insertSheet(s.name);
40.     sheet.clear().appendRow(s.headers);
41.     sheet.getRange("1:1").setBackground("#eeeeee").setFontWeight("bold");
42.   });
44.   let log = ss.getSheetByName('クォータログ') || ss.insertSheet('クォータログ');
45.   log.clear().getRange("A1:B4").setValues([
46.     ["項目","数値"],
47.     ["消費累計", 0],
48.     ["残り枠", 10000],
49.     ["最終更新", new Date()]
50.   ]);
51.   log.getRange("B2:B3").setBackground("#eeeeee");
52.   log.getRange("A6:F6").setValues([["日時", "内容・動画名", "消費", "累計", "エラーメッセージ", "送信リクエスト(JSON)"]])
53.      .setBackground("#eeeeee").setFontWeight("bold");
54.   
55.   ss.getSheetByName('再生リスト取得').activate();
56.   SpreadsheetApp.getUi().alert('セットアップ完了！');
57. }
59. /**
60.  * 1. リストを取得
61.  */
62. function fetchPlaylistVideos() {
63.   const ss = SpreadsheetApp.getActiveSpreadsheet();
64.   const sheetGet = ss.getSheetByName('再生リスト取得');
65.   const sheetAfter = ss.getSheetByName('並べ替え後');
66.   if (!sheetGet || !sheetAfter) return;
67.   
68.   sheetGet.clear();
69.   sheetGet.appendRow(['現在の順序(0始)', '動画タイトル', '動画ID', 'アニメシリーズ＋シーズン', 'PlaylistItemID', 'ステータス', '存在チェック']);
70.   sheetGet.getRange("1:1").setBackground("#eeeeee").setFontWeight("bold");
72.   let nextPageToken = '';
73.   let count = 0;
74.   let allRowsData = [];
76.   while (nextPageToken != null) {
77.     try {
78.       const res = YT.PlaylistItems.list('snippet,contentDetails,status', {
79.         playlistId: PLAYLIST_ID,
80.         maxResults: 50,
81.         pageToken: nextPageToken
82.       });
83.       
84.       // 【修正】取得に成功したタイミングで1ユニット記録
85.       logQuota("リスト取得API成功 (50件分ページ取得)", 1);
87.       const lastRowInSheet = sheetGet.getLastRow();
88.       const pageRows = res.items.map((item, index) => {
89.         const targetRow = lastRowInSheet + index + 1;
90.         const title = item.snippet.title;
91.         
92.         const prompt = "このセルの動画の曲のアニメタイトルを表示して。アニメ放送シーズンも検索して確認して表示してください。表示形式は、「アニメタイトル」＋「(シーズン)」としてください。ただし、「アニメタイトル」は「第2期」などシーズンを示すワードを省く";
93.         const geminiFormula = `=GEMINI("${prompt}", B${targetRow}:C${targetRow})`;
94.         const presenceCheckFormula = `=COUNTIF('並べ替え後'!A:A, A${targetRow})`;
95.         
96.         const privacy = item.status.privacyStatus;
97.         let statusLabel = "公開";
98.         if (title === 'Deleted video' || privacy === 'privacyStatusUnspecified') {
99.           statusLabel = "削除済み";
100.         } else if (privacy === 'private') {
101.           statusLabel = "非公開";
102.         } else if (privacy === 'unlisted') {
103.           statusLabel = "限定公開";
104.         }
106.         // 個別の取得進捗ログ（消費は0）
107.         logQuota(` └ 取得完了: ${title}`, 0);
109.         return [count++, title, item.contentDetails.videoId, geminiFormula, item.id, statusLabel, presenceCheckFormula];
110.       });
112.       if (pageRows.length > 0) {
113.         sheetGet.getRange(sheetGet.getLastRow() + 1, 1, pageRows.length, 7).setValues(pageRows);
114.         allRowsData = allRowsData.concat(pageRows);
115.       }
116.       nextPageToken = res.nextPageToken;
117.       
118.     } catch (e) {
119.       logQuota("❌取得エラー", 0, e.message);
120.       break;
121.     }
122.   }
124.   // 「並べ替え後」シートに「同期用数式」と「ROW連番」を準備
125.   sheetAfter.getRange(2, 1, sheetAfter.getMaxRows()-1, 7).clearContent();
126.   const totalVideos = allRowsData.length;
127.   if (totalVideos > 0) {
128.     const formulas = [];
129.     for (let i = 0; i < totalVideos; i++) {
130.       const r = i + 2;
131.       formulas.push([
132.         `=IFERROR(INDEX('再生リスト取得'!B:B, MATCH($A${r}, '再生リスト取得'!$A:$A, 0)), "番号未入力")`,
133.         `=IFERROR(INDEX('再生リスト取得'!C:C, MATCH($A${r}, '再生リスト取得'!$A:$A, 0)), "")`,
134.         `=IFERROR(INDEX('再生リスト取得'!D:D, MATCH($A${r}, '再生リスト取得'!$A:$A, 0)), "")`,
135.         `=IFERROR(INDEX('再生リスト取得'!E:E, MATCH($A${r}, '再生リスト取得'!$A:$A, 0)), "")`,
136.         `=IFERROR(INDEX('再生リスト取得'!F:F, MATCH($A${r}, '再生リスト取得'!$A:$A, 0)), "")`,
137.         `=ROW()-2`
138.       ]);
139.     }
140.     sheetAfter.getRange(2, 2, totalVideos, 6).setFormulas(formulas);
141.   }
142.   SpreadsheetApp.getUi().alert('取得完了！');
143. }
145. /**
146.  * 2. 削除・非表示動画をリストから一掃
147.  */
148. function purgeInvalidVideos() {
149.   const ss = SpreadsheetApp.getActiveSpreadsheet();
150.   const sheet = ss.getSheetByName('再生リスト取得');
151.   const data = sheet.getDataRange().getValues().slice(1);
152.   let count = 0;
154.   const confirm = SpreadsheetApp.getUi().alert('確認', '非公開・削除済み動画を削除しますか？', SpreadsheetApp.getUi().ButtonSet.YES_NO);
155.   if (confirm !== SpreadsheetApp.getUi().Button.YES) return;
157.   data.forEach(row => {
158.     if (row[5] === '非公開' || row[5] === '削除済み') {
159.       try {
160.         YT.PlaylistItems.remove(row[4]);
161.         count++;
162.         logQuota(`✅一掃成功: ${row[1]}`, 50);
163.         Utilities.sleep(1000);
164.       } catch (e) {
165.          logQuota(`❌一掃失敗: ${row[1]}`, 0, e.message);
166.       }
167.     }
168.   });
169.   SpreadsheetApp.getUi().alert(`${count}件削除しました。`);
170. }
172. /**
173.  * 3. 並べ替え後シートの順序をYouTubeに反映
174.  */
175. function applyNewOrder() {
176.   const ss = SpreadsheetApp.getActiveSpreadsheet();
177.   const sheetAfter = ss.getSheetByName('並べ替え後');
178.   if (!sheetAfter) return;
180.   const data = sheetAfter.getDataRange().getValues();
181.   const videoList = data.slice(1);
182.   let updateCount = 0;
183.   let errorCount = 0;
185.   SpreadsheetApp.getUi().alert('反映を開始します。G列が空欄の行はスキップされます。');
187.   for (let i = 0; i < videoList.length; i++) {
188.     const row = videoList[i];
189.     const videoTitle = row[1];
190.     const originalIdx = parseInt(row[0]);
191.     
192.     const targetIdxStr = row[6].toString();
193.     if (targetIdxStr === "") continue; // 空欄スキップ
194.     const targetIdx = parseInt(targetIdxStr);
195.     
196.     // 現在の位置（A列）と目標位置（G列）が一致していればスキップ
197.     if (originalIdx === targetIdx) continue;
199.     const playlistItemId = row[4].toString();
200.     const videoId = row[2].toString();
202.     if (!playlistItemId || playlistItemId === "番号未入力") continue;
204.     const resource = {
205.       "id": playlistItemId,
206.       "kind": "youtube#playlistItem",
207.       "snippet": {
208.         "playlistId": PLAYLIST_ID,
209.         "resourceId": { "kind": "youtube#video", "videoId": videoId },
210.         "position": targetIdx
211.       }
212.     };
214.     try {
215.       YT.PlaylistItems.update(resource, 'snippet');
216.       updateCount++;
217.       logQuota(`✅移動成功: ${videoTitle} (pos:${targetIdx})`, 50);
218.       Utilities.sleep(500);
219.     } catch (e) {
220.       errorCount++;
221.       logQuota(`❌移動失敗: ${videoTitle}`, 0, e.message, JSON.stringify(resource));
222.       if (e.message.indexOf('quota') !== -1) {
223.         SpreadsheetApp.getUi().alert('API制限に達しました。処理を停止します。');
224.         break;
225.       }
226.     }
227.   }
228.   SpreadsheetApp.getUi().alert(`終了。成功: ${updateCount}件 / エラー: ${errorCount}件`);
229. }
231. /**
232.  * 📊 ログを手動でリセット
233.  */
234. function resetQuotaLog() {
235.   const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('クォータログ');
236.   if (sheet) {
237.     sheet.getRange("B2").setValue(0);
238.     sheet.getRange("B3").setValue(10000);
239.     if (sheet.getLastRow() >= 7) sheet.getRange(7, 1, sheet.getLastRow() - 6, 6).clearContent();
240.   }
241. }
243. // --- 共通内部ロジック ---
245. function logQuota(operation, units, errorDetail = "", requestJson = "") {
246.   const ss = SpreadsheetApp.getActiveSpreadsheet();
247.   let logSheet = ss.getSheetByName('クォータログ');
248.   if (!logSheet) return;
250.   const now = new Date();
251.   const lastUpdate = logSheet.getRange("B4").getValue();
253.   if (lastUpdate instanceof Date && getQuotaDayId(lastUpdate) !== getQuotaDayId(now)) {
254.     logSheet.getRange("B2").setValue(0);
255.     logSheet.getRange("B3").setValue(10000);
256.     if (logSheet.getLastRow() >= 7) logSheet.getRange(7, 1, logSheet.getLastRow() - 6, 6).clearContent();
257.     logSheet.appendRow([now, "--- 日付変更リセット ---", 0, 0, "", ""]);
258.   }
260.   const currentUsed = logSheet.getRange("B2").getValue() || 0;
261.   const newTotal = currentUsed + units;
263.   logSheet.getRange("B2").setValue(newTotal);
264.   logSheet.getRange("B3").setValue(10000 - newTotal);
265.   logSheet.getRange("B4").setValue(now);
267.   logSheet.appendRow([now, operation, units, newTotal, errorDetail, requestJson]);
268. }
270. function getQuotaDayId(date) {
271.   const adjusted = new Date(date.getTime() - (16 * 60 * 60 * 1000));
272.   return adjusted.getFullYear() + "/" + (adjusted.getMonth() + 1) + "/" + adjusted.getDate();
273. }

コードを貼り付けた後スプレッドシートの画面に戻ると、「YouTubeツール」タブが表示されています。初回のセットアップは「YouTubeツール」＞「⚠️初回セットアップ実行」を選択します。

セットアップ実行が完了すると、以下の通り３つのタブとそれぞれヘッダが作成されます。

【STEP 2】現在のリスト取得とAI解析

セットアップが完了したら、「再生リスト取得」シートに再生リストを取得します。

また、以下のように「YouTubeツール」＞「1.リストを取得(数式準備込)」を選択します。

問題なく完了すると、以下のように完了メッセージが出力されます。

また、「クォータログ」シートを確認すると、以下のようにログとクォータの消費量が確認できます。

ここで、クォータというのは、今回YouTube Data API v3を利用しますが、利用制限があります。その制限量をクォータという指標でチェックされます。1日に10,000クォータ使えます。

再生リスト取得であれば50件取得で1クォータ消費ですが、再生リストの並べ替えであれば1件50クォータ消費します。1日に10,000クォータということは、1日に200本程度しか動画を並び替えることができません。そのため、今日はどのくらい使ったかを確認するためのログを用意しています。

クォータ消費は太平洋時間の午前0時（PT）、日本時間だとJST17:00頃のリセットになります。実際はサマータイムなどもあってずれたりしますが、JST17:00頃にはリセットされると覚えておけば十分です。

再生リスト取得が完了すると「再生リスト取得」シートに指定の再生リスト情報が出力されます。

「再生リスト取得」シートD列を確認してもらうと、数式が入っていることがわかると思います。ここはGeminiに並べ替えの情報を出力してもらう列にしています。

以下画面の赤枠の「生成して挿入」のボタンを押します。

すると、各セルのGeminiプロンプトが動作してくれて、アニメシリーズ名と放送シーズンを出力してくれます。これは便利！

このプロンプトの実行後は、各セルをざっと確認するようにしてください。今回は動画のタイトルからの情報で情報を出してくれているので、曲名が被っていたり、動画タイトルの情報が少なかったりするとGeminiが分からずに間違った回答を出します。そこは自分の再生リストである程度分かるでしょうから、数式ではなく、直接入力で補完してあげてください。

【STEP 3】Geminiに「最強の順序」を作ってもらう

この「再生リスト取得」シートができたらいよいよGeminiの出番です。

GeminiのアプリでもWebでもこのツールのスプレッドシートを添付してあげて、例えば以下のようなプロンプトを指定して並び替えてもらいます。

1. 添付の再生リスト取得シートの内容を以下の条件で並び替えたCSVリストを作成してください。
3. 【出力形式のルール】
4. ・並べ替え後は、「現在の順序(0始)」の列のみを出力すること。
5. ・各行の最後は改行すること。
6. ・Markdown、ヘッダー、挨拶は一切不要。
8. 【ソートの最優先ルール：シリーズの統一】
9. ・『ひぐらし』と『ひぐらし解』、『とある科学』と『とある魔術』、『ソードアート・オンライン』の各期など、シリーズ作品はタイトルの表記が多少違っていても、必ず同一グループとして一箇所に固めてください。
12. #優先順位
13. 1. 先頭：『推しの子』関連
14. 2. 最後：ライブのシメにふさわしい超人気曲
15. 3. シリーズ作品を同一グループとして固める（最重要）
16. 4. 同一シリーズ内では放送シーズンが古い順
17. 5. 曲が盛り上がる順
18. 6. アニメ作品の一般的な人気順

プロンプトのコツとしては、AIは文字列を正しく転記することは苦手です。そのため、「再生リスト取得」シート自体を並べ替えさせようとすると、動画IDやPlaylistItemIDが正しく転記されません。AIは特に意味の無い文字列の転記はかなり苦手のようです。そのため、「現在の順序(0始)」列のみに絞って並べ替えをさせます。

再生リスト取得シートと並べ替え後シートを別にすることで、ここが実質IDみたいな扱いもできますので、この転記が簡単な数字だけを並べ替えさせることでけっこう上手くいく確率が上がります。

プロンプトを以下のようにGeminiに貼り付けて実行します。

200曲もあると相当時間がかかりますが、ギリギリ返ってきます。失敗したら再実行で・・・ｗ

【STEP 4】並べ替え結果の反映とカスタマイズ

成功したら以下のボタンでコピーしてください。改行が多くなっているので、一旦サクラエディタに貼り付けた後に「並べ替え後」シートに貼り付けた方がいいです。

サクラエディタなどを経由して以下のように「並べ替え後」シートのA列に貼り付けます。

すると、B列以降は再生リスト取得時に数式が入っているので、B列以降の情報も転記されます。（Geminiが苦手な転記を数式でフォローしてあげます。）

また、「並び替え後」シートの一番下まで確認して、Geminiがソート後に番号出力を漏らしていないかも確認してください。漏れていた場合、どの番号が漏れているのかの存在チェックができるように「再生リスト取得」シートの「存在チェック」列を用意してますので、これで「0」になってて無いものを「並び替え後」シートに転記してGeminiの不足分を補完してあげてください。

ここからは、自分の好みの並べ替え順になっているかを順に確認していきます。

シリーズごとに並び替えたり、順番変えたり、などなど。Excelでの行入れ替えで塊で並び替えできたりするため、再生リストの手動並べ替えよりは圧倒的に楽だと思います。明確に並べ替えたい要件があるならGeminiに並び替えてもらう必要性も無いですね。

【STEP 5】YouTubeへの反映

並び替えが完了したら、以下の通り「YouTubeツール」＞「3. 並べ替え後シートの順序をYouTubeに反映」を選択して、ソート処理を実行してください。

「並び替え後」シートのG列の「並び替え後の順序」列の番号になるようにソート処理をしていきます。

ソートが完了したらメッセージが出力されますが、どこまで完了したのかは「クォータログ」シートのログを確認してください。クォータが足りなくなったりしたら、その部分から翌日再実行する必要があります。

その場合は、「並び替え後」シートのG列の「並び替え後の順序」列の番号を成功したところは値削除して再実行してください。値の無い行は処理スキップして全体の処理を進めます。

また、クォータ節約のため、「現在の順序」列と「並び替え後の順序」列の順番が同じ場合は処理をスキップします。ログに出てない場合はスキップされていますので、ご注意ください。

運用で役立つ「こだわり機能」

• 空欄スキップ機能：「並べ替え後」シートのG列の値を消した行は、処理から除外されます。APIのクォータ（1日の上限）が切れても、翌日そこから簡単に再開できます。

• クォータログ：今日のAPIで処理できる量を可視化したことで、本日あとどのくらい処理できるのか、翌日にしないといけないのかが一目で把握できます。

• 削除・非表示動画をリストから一掃機能：削除された動画や非公開動画をリストから一括削除する機能も搭載しています。削除されていない動画でも再生リストから削除したい場合は、「再生リスト取得」シートの「ステータス」列を「削除済み」に変えて実行してください。

まとめ

YouTube公式機能では不可能な「AIによるシリーズ順・放送時期順の爆速整理」が、このツールなら手動並び替えの苦行をしなくても完結します。一度セットアップしてしまえば、あとはAIと対話して貼り付けるだけ。

あなたのアニソンリストやライブ予習リストを、ぜひ「理想の順序」に生まれ変わらせてみてください！