Guida rapida di Google Apps Script

Le guide rapide spiegano come configurare ed eseguire un'app che chiama una l'API Google Workspace.

Le guide rapide di Google Workspace utilizzano le librerie client API per gestire alcune i dettagli del flusso di autenticazione e autorizzazione. È consigliabile di usare le librerie client per le tue app. Questa guida rapida utilizza un un approccio all'autenticazione semplificato, appropriato per gli ambienti di test completamente gestito di Google Cloud. Per un ambiente di produzione, consigliamo di imparare autenticazione e autorizzazione prima del giorno scelta delle credenziali di accesso che siano appropriati per la tua app.

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

Obiettivi

  • Crea lo script.
  • Abilita l'API People.
  • Esegui l'esempio.

Prerequisiti

  • Un dominio Google Workspace con accesso API abilitato.
  • Un Account Google nel dominio con privilegi amministrativi.

  • Accesso a Google Drive

Crea lo script

  1. Per creare un nuovo script, vai 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.

Abilitare l'API People

  1. Apri il progetto Apps Script.
  2. Fai clic su Editor .
  3. Accanto a Servizi, fai clic su Aggiungi un servizio. .
  4. Seleziona API People e fai clic su Aggiungi.

Esegui l'esempio

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

La prima volta che esegui l'esempio, ti verrà 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