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

Nos guias de início rápido, explicamos 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 lidar com alguns detalhes do fluxo de autenticação e autorização. Recomendamos que você use as bibliotecas de cliente para seus próprios apps. Neste guia de início rápido, usamos uma abordagem de autenticação simplificada apropriada 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 apropriadas para seu aplicativo.

Criar um Google Apps Script que faça solicitações à API Google Calendar.

Objetivos

  • Crie o script.
  • Ative a API Google Calendar.
  • Execute a amostra.

Pré-requisitos

  • Uma Conta do Google com o Google Agenda ativado.

  • Acesso ao Google Drive

Criar o script

  1. Acesse script.google.com/create para criar um novo script.
  2. Substitua o conteúdo do editor de script pelo seguinte código:

calendar/quickstart/quickstart.gs
/**
 * Lists 10 upcoming events in the user's calendar.
 * @see https://developers.google.com/calendar/api/v3/reference/events/list
 */
function listUpcomingEvents() {
  const calendarId = 'primary';
  // Add query parameters in optionalArgs
  const optionalArgs = {
    timeMin: (new Date()).toISOString(),
    showDeleted: false,
    singleEvents: true,
    maxResults: 10,
    orderBy: 'startTime'
    // use other optional query parameter here as needed.
  };
  try {
    // call Events.list method to list the calendar events using calendarId optional query parameter
    const response = Calendar.Events.list(calendarId, optionalArgs);
    const events = response.items;
    if (events.length === 0) {
      console.log('No upcoming events found');
      return;
    }
    // Print the calendar events
    for (const event of events) {
      let when = event.start.dateTime;
      if (!when) {
        when = event.start.date;
      }
      console.log('%s (%s)', event.summary, when);
    }
  } catch (err) {
    // TODO (developer) - Handle exception from Calendar API
    console.log('Failed with error %s', err.message);
  }
}

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

Ativar a API Google Calendar

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

Executar a amostra

No editor do Apps Script, clique em Executar.

A primeira vez que você executar o exemplo, ele solicitará que você autorize 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 inferior da janela.

Próximas etapas