Guida introduttiva a Google Apps Script

Crea uno script Google Apps Script che effettui 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ù sull' autenticazione e sull'autorizzazione prima di scegliere le credenziali di accesso appropriate per la tua app.

In Apps Script, le guide rapide di Google Workspace utilizzano i servizi avanzati di Google 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 abilitato.

  • Accesso a Google Drive

Crea lo script

  1. Crea un nuovo script nell'editor di script di Apps 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.

Configura lo script

Abilita 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 l'esempio

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 Esamina le 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