Guia de início rápido do Node.js

Conclua as etapas descritas no restante desta página e, em cerca de cinco minutos, você terá um aplicativo simples de linha de comando do Node.js que faz solicitações à API de dados do YouTube.

A amostra de código usada neste guia recupera o recurso channel para o canal do Google Developers do YouTube e imprime algumas informações básicas desse recurso.

Pré-requisitos

Para executar este guia de início rápido, você precisará do seguinte:

  • Node.js instalado.
  • A ferramenta de gerenciamento de pacotes npm (em inglês) vem com o Node.js.
  • Acesso à Internet e a um navegador da Web.
  • uma Conta do Google.

Etapa 1: ativar a API YouTube Data

  1. Use este assistente para criar ou selecionar um projeto no Google Developers Console e ativar a API automaticamente. Clique em Continuar e em Acessar credenciais.

  2. Na página Criar credenciais, clique no botão Cancelar.

  3. Na parte superior da página, selecione a guia OAuth consent screen. Selecione um Endereço de e-mail, insira um Nome de produto, se ainda não estiver definido, e clique no botão Salvar.

  4. Selecione a guia Credenciais, clique no botão Criar credenciais e selecione ID do cliente OAuth.

  5. Selecione o tipo de aplicativo Outro, insira o nome "Guia de início rápido da API YouTube Data" e clique no botão Criar.

  6. Clique em OK para dispensar a caixa de diálogo exibida.

  7. Clique no botão (Fazer o download do JSON) à direita do ID do cliente.

  8. Mova o arquivo salvo para o diretório de trabalho e renomeie-o como client_secret.json.

Etapa 2: instalar a biblioteca de cliente

Execute os seguintes comandos para instalar as bibliotecas usando npm:

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

Etapa 3: configurar o exemplo

Crie um arquivo chamado quickstart.js no diretório de trabalho e copie o seguinte código:

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

Etapa 4: executar a amostra

Execute o exemplo usando o seguinte comando:

node quickstart.js

Na primeira vez que você executar o exemplo, ele vai solicitar a autorização de acesso:

  1. Navegue até o URL fornecido no seu navegador da Web.

    Se ainda não estiver conectado à sua Conta do Google, você será solicitado a fazer login. Se você tiver feito login em várias Contas do Google, precisará escolher uma para usar na autorização.

  2. Clique no botão Aceitar.
  3. Copie o código que você recebeu, cole-o no prompt de linha de comando e pressione Enter.

Observações

  • As informações de autorização são armazenadas no sistema de arquivos para que as execuções subsequentes não solicitem autorização.
  • O fluxo de autorização neste exemplo foi projetado para um aplicativo de linha de comando. Para informações sobre como executar a autorização em um aplicativo da Web que usa a API YouTube Data, consulte Como usar o OAuth 2.0 para aplicativos de servidor da Web.

    Para informações sobre como executar a autorização em outros contextos, consulte a seção Como autorizar e autenticar do README da biblioteca.

Leitura adicional