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 API 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 aplicativos. 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 app.

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

Objetivos

  • Crie o script.
  • Ativar a API People.
  • 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 novo script acessando script.google.com/create.
  2. Substitua o conteúdo do editor de script pelo seguinte código:

people/quickstart/quickstart.gs
/**
 * Print the display name if available for 10 connections.
 */
function listConnectionNames() {
  try {
    /**
     * List the 10 connections/contacts of user
     * @see https://developers.google.com/people/api/rest/v1/people.connections/list
     */
    const connections = People.People.Connections.list('people/me', {
      pageSize: 10,
      personFields: 'names,emailAddresses'
      // use other query parameter here if needed.
    });
    connections.connections.forEach((person) => {
      // if contacts/connections is available, print the name of person.
      if (person.names && person.names.length === 0) {
        console.log('No display name found for connection.');
        return;
      }
      console.log(person.names[0].displayName);
    });
  } catch (err) {
    // TODO (developer) - Handle exception from People 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 People

  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 a API People e clique em Adicionar.

Executar a amostra

No editor do Apps Script, clique em Executar.

Na 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