Node.js クイックスタート

このページの残りの手順を完了して 5 分ほど経てば、YouTube Data API にリクエストを行うシンプルな Node.js コマンドライン アプリケーションが完成します。

このガイドで使用するサンプルコードは、GoogleDevelopers YouTube チャンネルの channel リソースを取得し、そのリソースから基本情報を出力します。

前提条件

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

• Node.js がインストールされている。
• npm パッケージ管理ツール（Node.js に付属）。
• インターネット アクセスとウェブブラウザ。
• Google アカウント。

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

1. Google Developers Console でこちらのウィザードを使ってプロジェクトを作成するか既存のプロジェクトを選択すると、自動的に API が有効になります。[続行]、[認証情報に進む] の順にクリックします。

2. [認証情報を作成] ページで、[キャンセル] ボタンをクリックします。

3. ページ上部の [OAuth 同意画面] タブを選択します。[メールアドレス] を選択し、[ユーザーに表示するサービス名] が設定されていない場合はサービス名を入力して、[保存] ボタンをクリックします。

4. [認証情報] タブを選択し、[認証情報を作成] ボタンをクリックして、[OAuth クライアント ID] を選択します。

5. アプリケーションの種類として [その他] を選択し、名前に「YouTube Data API Quickstart」と入力して、[作成] ボタンをクリックします。

6. [OK] をクリックして、ダイアログを閉じます。

7. クライアント ID の右側にある （JSON をダウンロード）ボタンをクリックします。

8. ダウンロードしたファイルを作業ディレクトリに移動し、名前を client_secret.json に変更します。

ステップ 2: クライアント ライブラリをインストールする

npm を使用してライブラリをインストールするには、次のコマンドを実行します。

npm install googleapis --save
npm install google-auth-library --save

ステップ 3: サンプルを設定する

作業ディレクトリに quickstart.js という名前のファイルを作成し、次のコードをコピーします。

var fs = require('fs');
var readline = require('readline');
var {google} = require('googleapis');
var OAuth2 = google.auth.OAuth2;

// If modifying these scopes, delete your previously saved credentials
// at ~/.credentials/youtube-nodejs-quickstart.json
var SCOPES = ['https://www.googleapis.com/auth/youtube.readonly'];
var TOKEN_DIR = (process.env.HOME || process.env.HOMEPATH ||
    process.env.USERPROFILE) + '/.credentials/';
var TOKEN_PATH = TOKEN_DIR + 'youtube-nodejs-quickstart.json';

// Load client secrets from a local file.
fs.readFile('client_secret.json', function processClientSecrets(err, content) {
  if (err) {
    console.log('Error loading client secret file: ' + err);
    return;
  }
  // Authorize a client with the loaded credentials, then call the YouTube API.
  authorize(JSON.parse(content), getChannel);
});

/**
 * Create an OAuth2 client with the given credentials, and then execute the
 * given callback function.
 *
 * @param {Object} credentials The authorization client credentials.
 * @param {function} callback The callback to call with the authorized client.
 */
function authorize(credentials, callback) {
  var clientSecret = credentials.installed.client_secret;
  var clientId = credentials.installed.client_id;
  var redirectUrl = credentials.installed.redirect_uris[0];
  var oauth2Client = new OAuth2(clientId, clientSecret, redirectUrl);

  // Check if we have previously stored a token.
  fs.readFile(TOKEN_PATH, function(err, token) {
    if (err) {
      getNewToken(oauth2Client, callback);
    } else {
      oauth2Client.credentials = JSON.parse(token);
      callback(oauth2Client);
    }
  });
}

/**
 * Get and store new token after prompting for user authorization, and then
 * execute the given callback with the authorized OAuth2 client.
 *
 * @param {google.auth.OAuth2} oauth2Client The OAuth2 client to get token for.
 * @param {getEventsCallback} callback The callback to call with the authorized
 *     client.
 */
function getNewToken(oauth2Client, callback) {
  var authUrl = oauth2Client.generateAuthUrl({
    access_type: 'offline',
    scope: SCOPES
  });
  console.log('Authorize this app by visiting this url: ', authUrl);
  var rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout
  });
  rl.question('Enter the code from that page here: ', function(code) {
    rl.close();
    oauth2Client.getToken(code, function(err, token) {
      if (err) {
        console.log('Error while trying to retrieve access token', err);
        return;
      }
      oauth2Client.credentials = token;
      storeToken(token);
      callback(oauth2Client);
    });
  });
}

/**
 * Store token to disk be used in later program executions.
 *
 * @param {Object} token The token to store to disk.
 */
function storeToken(token) {
  try {
    fs.mkdirSync(TOKEN_DIR);
  } catch (err) {
    if (err.code != 'EEXIST') {
      throw err;
    }
  }
  fs.writeFile(TOKEN_PATH, JSON.stringify(token), (err) => {
    if (err) throw err;
    console.log('Token stored to ' + TOKEN_PATH);
  });
}

/**
 * Lists the names and IDs of up to 10 files.
 *
 * @param {google.auth.OAuth2} auth An authorized OAuth2 client.
 */
function getChannel(auth) {
  var service = google.youtube('v3');
  service.channels.list({
    auth: auth,
    part: 'snippet,contentDetails,statistics',
    forUsername: 'GoogleDevelopers'
  }, function(err, response) {
    if (err) {
      console.log('The API returned an error: ' + err);
      return;
    }
    var channels = response.data.items;
    if (channels.length == 0) {
      console.log('No channel found.');
    } else {
      console.log('This channel\'s ID is %s. Its title is \'%s\', and ' +
                  'it has %s views.',
                  channels[0].id,
                  channels[0].snippet.title,
                  channels[0].statistics.viewCount);
    }
  });
}
nodejs-quickstart.js

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

次のコマンドを使用してサンプルを実行します。

node quickstart.js

サンプルを初めて実行すると、アクセスを承認するよう求められます。

1. ウェブブラウザで指定された URL に移動します。

   Google アカウントにログインしていない場合は、ログインを求めるメッセージが表示されます。複数の Google アカウントにログインしている場合は、承認に使用するアカウントを 1 つ選択するよう求められます。

2. [同意する] ボタンをクリックします。
3. 提供されたコードをコピーしてコマンドライン プロンプトに貼り付け、Enter キーを押します。

うまくいった

これで完了です。詳しくは、以下の「参考資料」をご覧ください。

エラーが発生しました

エラーになりました。 ご連絡いただきありがとうございます。このクイックスタートの問題を修正いたします。

メモ

• 認可情報はファイル システムに保存されるため、以降の実行時に認可を求めるプロンプトは表示されません。
• この例の認可フローは、コマンドライン アプリケーション用に設計されています。YouTube Data API を使用するウェブ アプリケーションで認可を行う方法については、ウェブサーバー アプリケーションに OAuth 2.0 を使用するをご覧ください。
  
  他のコンテキストで認可を行う方法については、ライブラリの README の認可と認証のセクションをご覧ください。

関連情報

• Google Developers Console ヘルプ ドキュメント
• Node.js 用 Google API クライアントのドキュメント
• YouTube Data API リファレンス ドキュメント