Guida introduttiva a Google Apps Script

Crea un Google Apps Script che effettua richieste all'API People.

Le guide rapide spiegano come configurare ed eseguire un'app che chiama un'API Google Workspace. Questa guida rapida utilizza un approccio di autenticazione semplificato adatto a un ambiente di test. Per un ambiente di produzione, ti consigliamo di scoprire di più su autenticazione e autorizzazione prima di scegliere le credenziali di accesso adatte alla tua app.

In Apps Script, le guide rapide di Google Workspace utilizzano i servizi Google avanzati per chiamare le API Google Workspace e gestire alcuni dettagli del flusso di autenticazione e autorizzazione.

Obiettivi

  • Configura l'ambiente.
  • Crea e configura lo script.
  • Esegui lo script.

Prerequisiti

  • Un dominio Google Workspace con l'accesso API abilitato.
  • Un Account Google in quel dominio con privilegi amministrativi.

  • Accesso a Google Drive

Crea lo script

  1. Crea un nuovo script nell'editor di Apps Script andando alla pagina script.google.com/create.
  2. Sostituisci i contenuti dell'editor di script con il seguente codice:

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. Fai clic su Salva .
  2. Fai clic su Progetto senza titolo, digita Guida rapida e fai clic su Rinomina.

Configurare lo script

Abilita l'API People

Apri il progetto Apps Script.

  1. Fai clic su Editor .
  2. Accanto a Servizi, fai clic su Aggiungi un servizio .
  3. Seleziona People API e fai clic su Aggiungi.

Esegui il campione

Nell'editor di Apps Script, fai clic su Esegui.

La prima volta che esegui l'esempio, ti viene chiesto di autorizzare l'accesso:

  1. Fai clic su Rivedi autorizzazioni.
  2. Scegli un account.
  3. Fai clic su Consenti.

Il log di esecuzione dello script viene visualizzato nella parte inferiore della finestra.

Passaggi successivi