Guia de início rápido do Google Apps Script

Crie um Google Apps Script que faça solicitações à API Google Sheets.

Os guias de início rápido 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 adequada para um ambiente de teste. Para um ambiente de produção, recomendamos aprender sobre autenticação e autorização antes de escolher as credenciais de acesso adequadas para seu app.

No Apps Script, os inícios rápidos do Google Workspace usam os Serviços avançados do Google para chamar as APIs do Google Workspace e processar alguns detalhes do fluxo de autenticação e autorização.

Objetivos

  • Configurar o ambiente.
  • Crie e configure o script.
  • Execute o script.

Pré-requisitos

  • Uma Conta do Google
  • Acesso ao Google Drive

Criar o script

  1. Acesse script.google.com/create e crie um script no editor do Apps Script.
  2. Substitua o conteúdo do editor de script pelo seguinte código:

sheets/quickstart/quickstart.gs
/**
 * Creates a Sheets API service object and prints the names and majors of
 * students in a sample spreadsheet:
 * https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit
 * @see https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/get
 */
function logNamesAndMajors() {
  const spreadsheetId = '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms';
  const rangeName = 'Class Data!A2:E';
  try {
    // Get the values from the spreadsheet using spreadsheetId and range.
    const values = Sheets.Spreadsheets.Values.get(spreadsheetId, rangeName).values;
    //  Print the values from spreadsheet if values are available.
    if (!values) {
      console.log('No data found.');
      return;
    }
    console.log('Name, Major:');
    for (const row in values) {
      // Print columns A and E, which correspond to indices 0 and 4.
      console.log(' - %s, %s', values[row][0], values[row][4]);
    }
  } catch (err) {
    // TODO (developer) - Handle Values.get() exception from Sheet API
    console.log(err.message);
  }
}

  1. Clique em Salvar .
  2. Clique em Projeto sem título, digite Guia de início rápido e clique em Renomear.

Configurar o script

Ativar a API Google Sheets

Abra o projeto do Apps Script.

  1. Clique em Editor .
  2. Ao lado de Serviços, clique em Adicionar um serviço .
  3. Selecione API Sheets e clique em Adicionar.

Executar a amostra

No editor do Apps Script, clique em Executar.

Na primeira vez que você executar a amostra, será necessário autorizar o acesso:

  1. Clique em Revisar permissões.
  2. Escolha uma conta.
  3. Clique em Permitir.

O registro de execução do script aparece na parte de baixo da janela.

Próximas etapas