Guida introduttiva a Google Apps Script

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

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 Account Google con Gmail attivato.

  • Accesso a Google Drive

Crea lo script

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

gmail/quickstart/quickstart.gs
/**
 * Lists all labels in the user's mailbox
 * @see https://developers.google.com/gmail/api/reference/rest/v1/users.labels/list
 */
function listLabels() {
  try {
    // Gmail.Users.Labels.list() API returns the list of all Labels in user's mailbox
    const response = Gmail.Users.Labels.list('me');
    if (!response || response.labels.length === 0) {
      // TODO (developer) - No labels are returned from the response
      console.log('No labels found.');
      return;
    }
    // Print the Labels that are available.
    console.log('Labels:');
    for (const label of response.labels ) {
      console.log('- %s', label.name);
    }
  } catch (err) {
    // TODO (developer) - Handle exception on Labels.list() API
    console.log('Labels.list() API failed with error %s', err.toString());
  }
}

  1. Fai clic su Salva .
  2. Fai clic su Progetto senza titolo, digita Guida rapida e fai clic su Rinomina.

Configurare lo script

Abilitare l'API Gmail

Apri il progetto Apps Script.

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