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

Os tutoriais rápidos explicam como configurar e executar um app que chama uma API do Google Workspace.

Os guias de início rápido do Google Workspace usam as bibliotecas de cliente da API para processar alguns detalhes do fluxo de autenticação e autorização. Recomendamos que você use as bibliotecas de cliente para seus próprios apps. 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.

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

Objetivos

  • Configure 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 novo 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 Untitled project, digite Quickstart e clique em Rename.

Configurar o script

Ativar a API Google Sheets

  1. Abra o projeto do Apps Script.
  1. Clique em Editor .
  2. Ao lado de Serviços, clique em Adicionar um serviço .
  3. Selecione a API Planilhas e clique em Adicionar.

Executar a amostra

No editor do Apps Script, clique em Run.

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

  1. Clique em Analisar 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