Livello di programmazione: intermedio
Durata: 25 minuti
Tipo di progetto: app Google Chat
Obiettivi
- Comprendi cosa fa la soluzione.
- Scopri cosa fanno i servizi Apps Script all'interno soluzione.
- Configurare l'ambiente.
- Configura lo script.
- Esegui lo script.
Informazioni su questa soluzione
Programma una riunione in Google Calendar da un messaggio diretto o da un in Google Chat. Puoi impostare dettagli specifici per la riunione, ad esempio soggetto, l'ora di inizio o la durata oppure usa le impostazioni predefinite per programmazione di riunioni.
Come funziona
Lo script dell'app di chat utilizza comandi slash e di dialogo per i dettagli delle riunioni dagli utenti e pianificare un evento nel calendario. La lo script include impostazioni predefinite della riunione che possono essere personalizzate in base alle tue esigenze e alle esigenze aziendali.
Servizi Apps Script
Questa soluzione utilizza i seguenti servizi:
- Servizio Calendar: crea il evento di calendario dalle informazioni fornite sulla riunione.
- Servizio di base: utilizza la classe
Session
per ottenere al fuso orario dello script. Calendar utilizza questo fuso orario quando stai programmando l'evento. - Servizio di pubblica utilità: formatta la data per l'evento di calendario e codifica l'ID evento per facilitare il recupero dell'URL dell'evento.
Prerequisiti
Per utilizzare questo esempio, sono necessari i seguenti prerequisiti:
- Un Account Google (gli account Google Workspace possono richiedono l'approvazione dell'amministratore).
- Un browser web con accesso a internet.
- Un progetto Google Cloud.
Configura l'ambiente
Apri il tuo progetto Cloud nella console Google Cloud
Se non è già aperto, apri il progetto Cloud che intendi utilizzare per questo esempio:
- Nella console Google Cloud, vai alla pagina Seleziona un progetto.
- 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, potrebbe essere necessario attivare la fatturazione per il progetto.
Attiva l'API
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.Nel tuo progetto Cloud, attiva l'API Google Chat.
Configurare la schermata per il consenso OAuth
Tutte le app di chat richiedono una configurazione della schermata di consenso. Configurazione in corso... la schermata per il consenso OAuth dell'app definisce ciò che Google mostra agli utenti e registra la tua app per permetterti di pubblicarla in un secondo momento.
- Nella console Google Cloud, vai al Menu > API e Servizi > Schermata consenso OAuth.
- In Tipo di utente, seleziona Interno, quindi fai clic su Crea.
- Compila il modulo di registrazione dell'app, quindi fai clic su Salva e continua.
Per ora, puoi saltare l'aggiunta di ambiti e fare clic su Salva e continua. In futuro, quando creerai un'app da utilizzare al di fuori del tuo Nell'organizzazione Google Workspace, devi modificare il Tipo di utente in Esterno e poi aggiungi gli ambiti di autorizzazione richiesti dalla tua app.
- Esamina il riepilogo della registrazione dell'app. Per apportare modifiche, fai clic su Modifica. Se l'app la registrazione sembra a posto, fai clic su Torna alla Dashboard.
Configurare lo script
Creare il progetto Apps Script
- Fai clic sul pulsante seguente per aprire Pianifica riunioni da Google Chat
progetto Apps Script.
Apri il progetto - Fai clic su Panoramica .
- Nella pagina Panoramica, fai clic su Crea una copia
.
Copia il numero del progetto Cloud
- Nella console Google Cloud, vai al Menu > IAM e Amministratore > Impostazioni.
- Copia il valore nel campo Numero progetto.
Impostare il progetto Cloud del progetto Apps Script
- Nel progetto Apps Script copiato
fai clic su Impostazioni progetto
.
- In Progetto Google Cloud Platform (Google Cloud), fai clic su Cambia progetto.
- In Numero di progetto Google Cloud, incolla il numero di progetto Google Cloud.
- Fai clic su Imposta progetto.
Crea un deployment di test
- Nel progetto Apps Script copiato, fai clic su Esegui il deployment. > Testa i deployment.
- Copia l'ID deployment principale per utilizzarlo in un passaggio successivo e fai clic su Fine.
Configura l'API Chat
- Nella console Google Cloud, vai alla pagina dell'API Chat.
Vai all'API Chat - Fai clic su Configurazione.
- Configura l'API Chat con le seguenti informazioni:
- Nome:
Meeting Scheduler
- URL avatar: aggiungi un URL che indirizza a un'immagine con una dimensione minima di 256 x 256 pixel.
- Descrizione:
Quickly create meetings.
- Funzionalità: seleziona entrambe le caselle per consentire agli utenti di inviare messaggi direttamente all'app e aggiungerla agli spazi.
- Connection settings (Impostazioni di connessione): fai clic su Apps Script e inserisci il valore l'ID deployment head.
- Comandi slash: aggiungi comandi slash per
/help
e/schedule_Meeting
procedendo nel seguente modo:- Fai clic su Aggiungi comando slash e configuralo con quanto segue
informazioni:
- .
- Nome:
/help
- ID comando:
1
- Descrizione:
Learn what this app does.
- Nome:
- Fai di nuovo clic su Aggiungi comando slash e configuralo con quanto segue
informazioni:
- .
- Nome:
/schedule_Meeting
- ID comando:
2
- Descrizione:
Schedule a meeting.
- Seleziona la finestra di dialogo Apre una finestra di dialogo.
- Nome:
- Fai clic su Aggiungi comando slash e configuralo con quanto segue
informazioni:
- Autorizzazioni: seleziona Persone e gruppi specifici nel dominio e inserisci il tuo indirizzo email.
- Nome:
- Fai clic su Salva e aggiorna la pagina.
- Nella pagina di configurazione, in Stato applicazione, imposta lo stato su Dal vivo - Disponibile per gli utenti.
- Fai clic su Salva.
Esegui lo script
- Apri Google Chat.
- Fai clic su Avvia una chat .
- Cerca il nome dell'app,
Meeting Scheduler
. - Invia un messaggio iniziale, ad esempio
hello
, per richiedere l'autorizzazione. Quando l'app risponde, fai clic su Configura e autorizza l'app. Se nella schermata per il consenso OAuth viene visualizzato l'avviso Questa app non è stata verificata. continua selezionando Avanzate > Vai a {Project Name} (non sicuro).
Invia
/schedule_Meeting
all'app.Nella finestra di dialogo, aggiungi almeno un indirizzo email di invito. Puoi aggiornare altri campi o utilizzare le voci predefinite.
Fai clic su Invia.
Per visualizzare la riunione, fai clic su Apri evento di Calendar.
Esamina il codice
Per esaminare il codice Apps Script per questa soluzione, fai clic su Visualizza il codice sorgente di seguito:
Visualizza codice sorgente
Code.gs
Dialog.gs
Utilities.gs
Collaboratori
Questo campione è gestito da Google con l'aiuto degli Esperti Google Developers.