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 nos 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, é recomendável aprender sobre autenticação e autorização antes de escolher as credenciais de acesso adequadas para seu app.

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

Objetivos

  • Crie o script.
  • Ative a API Admin SDK.
  • Execute a amostra.

Pré-requisitos

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

  • Acesso ao Google Drive

Criar o script

  1. Crie um script acessando script.google.com/create.
  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.

Ativar a API Admin SDK

  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 Admin Reports e clique em Adicionar.

Executar a amostra

No editor do Apps Script, clique em Executar.

Na primeira execução do exemplo, ele solicita 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 é exibido na parte inferior da janela.

Próximas etapas