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

Os guias de início rápido explicam como configurar e executar um app que chama uma a API Google Workspace.

Os guias de início rápido do Google Workspace usam as bibliotecas de cliente da API para lidar com algumas do fluxo de autenticação e autorização. Recomendamos que você você usa as bibliotecas de cliente para seus próprios aplicativos. Este guia de início rápido usa um autenticação simplificada, adequada para um teste de nuvem. Para um ambiente de produção, recomendamos aprender sobre autenticação e autorização antes como escolher as credenciais de acesso adequados para seu app.

Crie um Google Apps Script que faz solicitações à API Directory.

Objetivos

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

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. Acesse script.google.com/create para criar um novo script.
  2. Substitua o conteúdo do editor de script pelo seguinte código:

adminSDK/directory/quickstart.gs
/**
 * Lists users in a Google Workspace domain.
 * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list
 */
function listUsers() {
  const optionalArgs = {
    customer: 'my_customer',
    maxResults: 10,
    orderBy: 'email'
  };
  try {
    const response = AdminDirectory.Users.list(optionalArgs);
    const users = response.users;
    if (!users || users.length === 0) {
      console.log('No users found.');
      return;
    }
    // Print the list of user's full name and email
    console.log('Users:');
    for (const user of users) {
      console.log('%s (%s)', user.primaryEmail, user.name.fullName);
    }
  } catch (err) {
    // TODO (developer)- Handle exception from the Directory API
    console.log('Failed with error %s', err.message);
  }
}

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

Configurar o script

Ativar a API Directory

  1. Abra o projeto do Apps Script.
  1. Clique em Editor .
  2. Ao lado de Serviços, clique em Adicionar um serviço .
  3. Selecionar API Admin Directory 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