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

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

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

  • Um domínio do Google Workspace com o acesso à API ativado.
  • Uma Conta do Google nesse domínio com privilégios de administrador.

  • 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:

adminSDK/reports/quickstart.gs
/**
 * List login events for a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list
 */
function listLogins() {
  const userKey = 'all';
  const applicationName = 'login';
  const optionalArgs = {
    maxResults: 10
  };
  try {
    const response = AdminReports.Activities.list(userKey, applicationName, optionalArgs);
    const activities = response.items;
    if (!activities || activities.length === 0) {
      console.log('No logins found.');
      return;
    }
    // Print login events
    console.log('Logins:');
    for (const activity of activities) {
      console.log('%s: %s (%s)', activity.id.time, activity.actor.email,
          activity.events[0].name);
    }
  } catch (err) {
    // TODO (developer)- Handle exception from the Report  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.

Configurar o script

Ativar a API Admin SDK

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 Admin SDK 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