Guida introduttiva a Google Apps Script

Crea uno script Google Apps Script che effettua richieste all'API Directory.

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:

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. 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 Directory

Apri il progetto Apps Script.

  1. Fai clic su Editor .
  2. Accanto a Servizi, fai clic su Aggiungi un servizio .
  3. Seleziona API Directory Admin 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