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

Crie um aplicativo de linha de comando Node.js que faça solicitações para a API Google Slides.

Os tutoriais rápidos explicam como configurar e executar um app que chama uma API do Google Workspace. Este guia de início rápido usa uma abordagem de autenticação simplificada que é adequada para um ambiente de teste. Para um ambiente de produção, recomendamos que você aprenda sobre autenticação e autorização antes de escolher as credenciais de acesso adequadas para o app.

Este guia de início rápido usa as bibliotecas de cliente de API recomendadas do Google Workspace para processar alguns detalhes do fluxo de autenticação e autorização.

Objetivos

• Prepare o ambiente.
• Instale a biblioteca de cliente.
• Configure a amostra.
• Execute a amostra.

Pré-requisitos

Para executar este guia de início rápido, você precisa dos seguintes pré-requisitos:

• Node.js e npm instalados.
• Um projeto do Google Cloud.

• Uma Conta do Google

Configurar o ambiente

Para concluir este guia de início rápido, configure seu ambiente.

Ativar a API

Antes de usar as APIs do Google, você precisa ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.

• No console do Google Cloud, ative a API Google Slides.

  Ativar a API

Configurar a tela de permissão OAuth

Se você estiver usando um novo projeto do Google Cloud para concluir este guia de início rápido, configure a tela de consentimento do OAuth. Se você já concluiu esta etapa para seu projeto do Cloud, pule para a próxima seção.

1. No console do Google Cloud, acesse Menu > > Marca.

   Acessar "Branding"

2. Se você já tiver configurado o , poderá configurar as seguintes configurações da tela de consentimento do OAuth em Marca, Público-alvo e Acesso a dados. Se você receber a mensagem ainda não configurado, clique em Começar:
1. Em Informações do app, em Nome do app, insira um nome para o app.
2. Em E-mail para suporte do usuário, escolha um endereço de e-mail de suporte para que os usuários entrem em contato com você se tiverem dúvidas sobre o consentimento.
3. Clique em Próxima.
4. Em Público, selecione Interno.
5. Clique em Próxima.
6. Em Dados de contato, insira um endereço de e-mail para receber notificações sobre as mudanças no projeto.
7. Clique em Próxima.
8. Em Concluir, analise a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a política de dados do usuário dos serviços de API do Google.
9. Clique em Continuar.
10. Clique em Criar.
3. Por enquanto, você pode pular a adição de escopos. No futuro, quando você criar um app para uso fora da sua organização do Google Workspace, será necessário mudar o Tipo de usuário para Externo. Em seguida, adicione os escopos de autorização necessários para o app. Para saber mais, consulte o guia completo Configurar a permissão OAuth.

Autorizar credenciais para um aplicativo para computador

Para autenticar usuários finais e acessar dados do usuário no app, crie um ou mais IDs do cliente OAuth 2.0. Um ID do cliente é usado para identificar um único app nos servidores OAuth do Google. Se o app for executado em várias plataformas, crie um ID do cliente separado para cada plataforma.

Atenção: este guia de início rápido precisa ser executado localmente e com acesso a um navegador. Ele não funciona se for executado em um terminal remoto, como o Cloud Shell ou por SSH.

1. No console do Google Cloud, acesse Menu > > Clientes.

   Acesse "Clientes"

2. Clique em Criar cliente.
3. Clique em Tipo de aplicativo > App para computador.
4. No campo Nome, digite um nome para a credencial. Esse nome é mostrado apenas no console do Google Cloud.
5. Clique em Criar.

   A credencial recém-criada aparece em "IDs de cliente OAuth 2.0".

6. Salve o arquivo JSON baixado como credentials.json e mova-o para o diretório de trabalho.

Instale a biblioteca de cliente

• Instale as bibliotecas usando o npm:

  npm install googleapis@105 @google-cloud/local-auth@2.1.0 --save
  

Configure a amostra

1. No diretório de trabalho, crie um arquivo chamado index.js.

2. No arquivo, cole o seguinte código:

   slides/quickstart/index.js

   Ver no GitHub
   const fs = require('fs').promises;
   const path = require('path');
   const process = require('process');
   const {authenticate} = require('@google-cloud/local-auth');
   const {google} = require('googleapis');
   
   // If modifying these scopes, delete token.json.
   const SCOPES = ['https://www.googleapis.com/auth/presentations.readonly'];
   // The file token.json stores the user's access and refresh tokens, and is
   // created automatically when the authorization flow completes for the first
   // time.
   const TOKEN_PATH = path.join(process.cwd(), 'token.json');
   const CREDENTIALS_PATH = path.join(process.cwd(), 'credentials.json');
   
   /**
    * Reads previously authorized credentials from the save file.
    *
    * @return {Promise<OAuth2Client|null>}
    */
   async function loadSavedCredentialsIfExist() {
     try {
       const content = await fs.readFile(TOKEN_PATH);
       const credentials = JSON.parse(content);
       return google.auth.fromJSON(credentials);
     } catch (err) {
       return null;
     }
   }
   
   /**
    * Serializes credentials to a file compatible with GoogleAuth.fromJSON.
    *
    * @param {OAuth2Client} client
    * @return {Promise<void>}
    */
   async function saveCredentials(client) {
     const content = await fs.readFile(CREDENTIALS_PATH);
     const keys = JSON.parse(content);
     const key = keys.installed || keys.web;
     const payload = JSON.stringify({
       type: 'authorized_user',
       client_id: key.client_id,
       client_secret: key.client_secret,
       refresh_token: client.credentials.refresh_token,
     });
     await fs.writeFile(TOKEN_PATH, payload);
   }
   
   /**
    * Load or request or authorization to call APIs.
    *
    */
   async function authorize() {
     let client = await loadSavedCredentialsIfExist();
     if (client) {
       return client;
     }
     client = await authenticate({
       scopes: SCOPES,
       keyfilePath: CREDENTIALS_PATH,
     });
     if (client.credentials) {
       await saveCredentials(client);
     }
     return client;
   }
   
   /**
    * Prints the number of slides and elements in a sample presentation:
    * https://docs.google.com/presentation/d/1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc/edit
    * @param {google.auth.OAuth2} auth The authenticated Google OAuth client.
    */
   async function listSlides(auth) {
     const slidesApi = google.slides({version: 'v1', auth});
     const res = await slidesApi.presentations.get({
       presentationId: '1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc',
     });
     const slides = res.data.slides;
     if (!slides || slides.length === 0) {
       console.log('No slides found.');
       return;
     }
     console.log('The presentation contains %s slides:', slides.length);
     res.data.slides.forEach((slide, i) => {
       console.log(
           `- Slide #${i + 1} contains ${slide.pageElements.length} elements.`,
       );
     });
   }
   authorize().then(listSlides).catch(console.error);

Executar a amostra

1. No diretório de trabalho, execute o exemplo:

   node .
   

2. Na primeira vez que você executar o exemplo, será necessário autorizar o acesso:
   1. Faça login na sua Conta do Google, caso ainda não tenha feito. Se você tiver feito login em várias contas, selecione uma para usar na autorização.
   2. Clique em Aceitar.

   O aplicativo Node.js é executado e chama a API Google Slides.

   As informações de autorização são armazenadas no sistema de arquivos. Assim, na próxima vez que você executar o código de exemplo, não será necessário fazer a autorização.

Próximas etapas

• Resolver problemas de autenticação e autorização
• Documentação de referência da API Slides
• Seção google-api-nodejs-client do GitHub