Guida introduttiva a Google Apps Script

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

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

Configura il progetto Cloud

Se utilizzi un nuovo progetto Google Cloud per completare questa guida rapida, devi configurarlo e aggiungerti come utente di test. Se hai già completato questi passaggi per il tuo progetto Cloud, vai alla sezione successiva.

Apri il progetto Cloud nella console Google Cloud

Se non è già aperto, apri il progetto Cloud che intendi utilizzare per questo esempio:

  1. Nella console Google Cloud, vai alla pagina Seleziona un progetto.

    Seleziona un progetto Cloud

  2. Seleziona il progetto Google Cloud che vuoi utilizzare. In alternativa, fai clic su Crea progetto e segui le istruzioni sullo schermo. Se crei un progetto Google Cloud, potresti dover attivare la fatturazione per il progetto.

Attiva l'API Chat

Prima di utilizzare le API di Google, devi attivarle in un progetto Google Cloud. Puoi attivare una o più API in un singolo progetto Google Cloud.

  • Nella console Google Cloud, abilita l'API Google Chat.

    Abilita l'API

  1. Nella console dell'API di Google, vai a Menu > Piattaforma Google Auth > Branding.

    Vai a Branding

  2. Se hai già configurato la piattaforma Google Auth, puoi configurare le seguenti impostazioni della schermata per il consenso OAuth in Branding, Pubblico e Accesso ai dati. Se visualizzi il messaggio Google Auth platform not configured yet (La piattaforma Google Auth non è ancora configurata), fai clic su Inizia:
    1. In Informazioni sull'app, nel campo Nome app, inserisci un nome per l'app.
    2. In Email di assistenza utente, scegli un indirizzo email di assistenza a cui gli utenti possono contattarti se hanno domande sul loro consenso.
    3. Fai clic su Avanti.
    4. In Pubblico, seleziona Interno.
    5. Fai clic su Avanti.
    6. In Dati di contatto, inserisci un indirizzo email a cui ricevere notifiche in caso di modifiche al progetto.
    7. Fai clic su Avanti.
    8. In Fine , esamina le Norme relative ai dati utente dei servizi API di Google e, se le accetti, seleziona Accetto le Norme relative ai dati utente: servizi API di Google.
    9. Fai clic su Continua.
    10. Fai clic su Crea.
  3. Per il momento, puoi saltare l'aggiunta di ambiti. In futuro, quando crei un'app da utilizzare al di fuori della tua organizzazione Google Workspace, devi impostare Tipo di utente su Esterno. Aggiungi poi gli ambiti di autorizzazione richiesti dall'app. Per saperne di più, consulta la guida completa Configurare il consenso OAuth guide.

Configura l'app Google Chat

Per chiamare l'API Google Chat, devi configurare un'app Google Chat. Per tutte le richieste di scrittura, Google Chat attribuisce l'app Google Chat nell'interfaccia utente utilizzando le seguenti informazioni.

  1. Nella console dell'API di Google, vai alla pagina Configurazione dell'API Chat:

    Vai alla pagina di configurazione dell'API Chat

  2. In Informazioni sull'applicazione, inserisci le seguenti informazioni:

    1. Nel campo Nome app, inserisci Chat API quickstart app.
    2. Nel campo URL avatar, inserisci https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. Nel campo Descrizione, inserisci Quickstart for calling the Chat API.

  3. In Funzionalità interattive, fai clic sul pulsante di attivazione/disattivazione Abilita funzionalità interattive per disabilitare le funzionalità interattive per l' app Chat.

  4. Fai clic su Salva.

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:

chat/quickstart/Code.gs
/**
 * This quickstart sample shows how to list spaces with user credential
 *
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces.readonly'
 * referenced in the manifest file (appsscript.json).
 */
function listSpaces() {
  // Initialize request argument(s)
  // Filter spaces by space type (SPACE or GROUP_CHAT or DIRECT_MESSAGE)
  const filter = 'space_type = "SPACE"';

  // Iterate through the response pages using page tokens
  let responsePage;
  let pageToken = null;
  do {
    // Request response pages
    responsePage = Chat.Spaces.list({
      filter: filter,
      pageToken: pageToken,
    });
    // Handle response pages
    if (responsePage.spaces) {
      for (const space of responsePage.spaces) {
        console.log(space);
      }
    }
    // Update the page token to the next one
    pageToken = responsePage.nextPageToken;
  } while (pageToken);
}

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

Configura lo script

Copia il numero del progetto Cloud

  1. Nella console dell'API di Google, vai a Menu > IAM e amministrazione > Impostazioni.

    Vai a IAM e amministrazione > Impostazioni

  2. Nel campo Numero progetto, copia il valore.
  1. Apri il progetto Apps Script.
  2. Fai clic su Impostazioni progetto .
  3. In Progetto Google Cloud Platform (Google Cloud), fai clic su Cambia progetto.
  4. In Numero progetto Google Cloud, incolla il numero del progetto Google Cloud.
  5. Fai clic su Imposta progetto.

Abilita l'API Google Chat

Apri il progetto Apps Script.

  1. Fai clic su Impostazioni progetto .
  2. In Impostazioni generali, abilita Mostra il file manifest "appsscript.json" nell'editor.
  3. Fai clic su Editor , seleziona il file appscript.json e sostituisci i contenuti con il seguente codice:

chat/quickstart/appsscript.json
{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": ["https://www.googleapis.com/auth/chat.spaces.readonly"],
  "chat": {},
  "dependencies": {
    "enabledAdvancedServices": [
      {
        "userSymbol": "Chat",
        "version": "v1",
        "serviceId": "chat"
      }
    ]
  }
}

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