Google Apps Script クイックスタート

このページの残りの手順を完了すると、数分で YouTube Data API にリクエストを行う簡単な Google Apps Script が作成されます。

このサンプルアプリケーションは、YouTube チャンネルのデータをスプレッドシートに追加する方法を示しています。

前提条件

このクイックスタートを実行するには、次のものが必要です。

インターネットアクセスとウェブブラウザ。
Google アカウント。
Google ドライブへのアクセス。

ステップ 1: スクリプトを作成する

ウェブブラウザで Google ドライブを開きます。
[新規] > [Google スプレッドシート] をクリックします。
新しいスプレッドシートで、[拡張機能] > [Apps Script] をクリックします。

スクリプトエディタの内容を次のコードに置き換えます。

// Note: Apps Script automatically requests authorization
// based on the API's used in the code.

function channelsListByUsername(part, params) {
  var response = YouTube.Channels.list(part,
                                       params);
  var channel = response.items[0];
  var dataRow = [channel.id, channel.snippet.title, channel.statistics.viewCount];
  SpreadsheetApp.getActiveSpreadsheet().appendRow(dataRow);
}

function getChannel() {
  var ui = SpreadsheetApp.getUi();
  var channelName = ui.prompt("Enter the channel name: ").getResponseText();
  channelsListByUsername('snippet,contentDetails,statistics',
                         {'forUsername': channelName});
}

function getGoogleDevelopersChannel() {
  channelsListByUsername('snippet,contentDetails,statistics',
                         {'forUsername': 'GoogleDevelopers'});
}

function onOpen() {
  var firstCell = SpreadsheetApp.getActiveSheet().getRange(1, 1).getValue();
  if (firstCell != 'ID') {
    var headerRow = ["ID", "Title", "View count"];
    SpreadsheetApp.getActiveSpreadsheet().appendRow(headerRow);
  }
  var ui = SpreadsheetApp.getUi();
  ui.createMenu('YouTube Data')
  .addItem('Add channel data', 'getChannel')
 
 .addSeparator()
  .addItem('Add GoogleDevelopers data', 'getGoogleDevelopersChannel')
  .addToUi();
}
quickstart.gs

[保存] をクリックします。
左上の [無題のプロジェクト] をクリックし、「Quickstart」と入力して、[名前を変更] をクリックします。

ステップ 2: YouTube Data API を有効にする

左側の [エディタ] をクリックします。
左側の [サービス] の横にある [サービスを追加] アイコンをクリックします。
[YouTube Data API] をクリックし、[追加] をクリックします。

ステップ 3: サンプルを実行する

スプレッドシートを再読み込みします。コードを追加した後でスプレッドシートを初めて読み込むと、最初の行に ID、タイトル、視聴回数というヘッダーが入力されます。
メニューバーで [YouTube Data] > [Add GoogleDevelopers data] をクリックして、GoogleDevelopers チャンネルに関する情報をスプレッドシートに追加します。（YouTube データメニューは、標準メニュー（[ファイル]、[編集]、[表示] など）の横に表示されます）。

サンプルを初めて実行すると、アクセス権限の付与を求めるメッセージが表示されます。
1. [権限を確認] をクリックします。
2. アカウントを選択してください。
3. [許可] をクリックします。
メニューバーで、[YouTube データ] > [チャンネルデータを追加] をクリックして、選択したチャンネルのデータを追加します。プロンプトが表示されたら、チャンネル名（「GoogleDevelopers」や「SaturdayNightLive」など）を入力して [OK] をクリックします。スクリプトは、そのチャンネルのデータを取得してスプレッドシートに追加します。

参考資料

トラブルシューティング

ReferenceError: 「[API 名]」が定義されていません

このエラーは、Apps Script コードエディタで API がオンになっていない場合に発生します。ステップ 2.b に戻り、対応する切り替えが [オン] に設定されていることを確認します。