Panduan Memulai Node.js

Selesaikan langkah-langkah yang dijelaskan di bagian tersisa pada halaman ini, dan dalam sekitar lima menit, Anda akan memiliki aplikasi command line Node.js sederhana yang membuat permintaan ke YouTube Data API.

Kode contoh yang digunakan dalam panduan ini mengambil resource channel untuk channel YouTube GoogleDevelopers dan mencetak beberapa informasi dasar dari resource tersebut.

Prasyarat

Untuk menjalankan quickstart ini, Anda memerlukan:

  • Node.js telah diinstal.
  • Alat pengelolaan paket npm (disertakan dengan Node.js).
  • Akses ke internet dan browser web.
  • Akun Google.

Langkah 1: Aktifkan YouTube Data API

  1. Gunakan wizard ini untuk membuat atau memilih project di Konsol Google Developers dan mengaktifkan API secara otomatis. Klik Lanjutkan, lalu Buka kredensial.

  2. Di halaman Create credentials, klik tombol Cancel.

  3. Di bagian atas halaman, pilih tab Layar persetujuan OAuth. Pilih Alamat email, masukkan Nama produk jika belum ditetapkan, lalu klik tombol Simpan.

  4. Pilih tab Kredensial, klik tombol Buat kredensial, lalu pilih ID klien OAuth.

  5. Pilih jenis aplikasi Lainnya, masukkan nama "YouTube Data API Quickstart", lalu klik tombol Buat.

  6. Klik Oke untuk menutup dialog yang muncul.

  7. Klik tombol (Download JSON) di sebelah kanan client ID.

  8. Pindahkan file yang didownload ke direktori kerja Anda dan ganti namanya menjadi client_secret.json.

Langkah 2: Instal library klien

Jalankan perintah berikut untuk menginstal library menggunakan npm:

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

Langkah 3: Siapkan contoh

Buat file bernama quickstart.js di direktori kerja Anda dan salin kode berikut:

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

Langkah 4: Jalankan contoh

Jalankan contoh menggunakan perintah berikut:

node quickstart.js

Saat pertama kali dijalankan, contoh aplikasi akan meminta Anda untuk memberikan otorisasi akses:

  1. Buka URL yang diberikan di browser web Anda.

    Jika belum login ke Akun Google, Anda akan diminta untuk login. Jika Anda login ke beberapa Akun Google, Anda akan diminta untuk memilih satu akun yang akan digunakan untuk otorisasi.

  2. Klik tombol Setuju.
  3. Salin kode yang diberikan, tempelkan ke command line prompt, lalu tekan Enter.

Catatan

  • Informasi otorisasi disimpan di sistem file, sehingga eksekusi berikutnya tidak akan meminta otorisasi.
  • Alur otorisasi dalam contoh ini dirancang untuk aplikasi command line. Untuk informasi tentang cara melakukan otorisasi di aplikasi web yang menggunakan YouTube Data API, lihat Menggunakan OAuth 2.0 untuk Aplikasi Server Web.

    Untuk mengetahui informasi tentang cara melakukan otorisasi dalam konteks lain, lihat bagian Memberikan Otorisasi dan Mengautentikasi di README library.

Bacaan lebih lanjut