Livello di programmazione: intermedio
Durata: 30 minuti
Tipo di progetto: componente aggiuntivo di Google Workspace
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
La copia manuale delle macro di Fogli Google da un foglio di lavoro all'altro può essere richiede molto tempo e soggetta a errori. Questo componente aggiuntivo di Google Workspace automaticamente copia un progetto di script e lo allega a un foglio di lavoro specificato dall'utente. Sebbene questa soluzione si concentra sulle macro di Fogli, puoi utilizzarla per copiare e condividere gli script associati a un container.
Come funziona
Lo script copia il progetto Apps Script associato al foglio di lavoro originale e crea un progetto Apps Script duplicato associate al foglio di lavoro specificato dall'utente.
Servizi Apps Script
Questa soluzione utilizza i seguenti servizi:
- Servizio di recupero URL: si connette alle app API Script per copiare il progetto di origine e crearne una copia.
- Servizio Script: autorizza Apps Script per evitare una seconda richiesta di autorizzazione.
- Servizio fogli di lavoro: apre il target per aggiungere il progetto Apps Script copiato.
- Servizio carte: crea l'interfaccia utente del componente aggiuntivo.
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.
L'API Google Apps Script è stata attivata nel Impostazioni della dashboard di Apps Script.
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.
Attivare l'API Google Apps Script
Questa guida rapida utilizza l'API Google Apps Script.
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 Apps Script.
Configurare la schermata per il consenso OAuth
I componenti aggiuntivi di Google Workspace richiedono una configurazione della schermata per il consenso. Configurazione in corso... la schermata per il consenso OAuth del componente aggiuntivo definisce quale viene mostrato agli utenti.
- 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 la sezione Condividi una macro
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.
Installa un deployment di prova
- Nel progetto Apps Script copiato, fai clic su Editor. .
- Apri il file
UI.gs
e fai clic su Esegui. Quando richiesto, autorizza lo script. - Fai clic su Esegui il deployment > Testa i deployment.
- Fai clic su Installa > Fine.
Ottieni le informazioni sullo script della macro e sul foglio di lavoro
- Apri un foglio di lavoro Fogli che contenga una macro e per il quale disponi dell'autorizzazione modifica. Per utilizzare un foglio di lavoro di esempio, crea una copia della Macro di esempio un foglio di lavoro.
- Fai clic su Estensioni > Apps Script.
- Nel progetto Apps Script, fai clic su
Impostazioni progetto
.
- Sotto l'ID script, fai clic su Copia.
- Metti da parte l'ID script per utilizzarlo in un passaggio successivo.
- Apri o crea un nuovo foglio di lavoro in cui aggiungere la macro. Devi disponi dell'autorizzazione per modificare il foglio di lavoro.
- Copia l'URL del foglio di lavoro e mettilo da parte per utilizzarlo in un passaggio successivo.
Esegui lo script
Verifica che l'API Google Apps Script sia attivata nelle impostazioni della dashboard. Segui i passaggi nelle sezioni seguenti per eseguire lo script.
Copia la macro
- In Fogli, nella barra laterale destra, apri il componente aggiuntivo Condividi Macro
.
- In Macro di origine, incolla l'ID script.
- In Foglio di lavoro di destinazione, incolla l'URL del foglio di lavoro.
- Fai clic su Condividi macro.
- Fai clic su Autorizza accesso e autorizza il componente aggiuntivo.
- Ripeti i passaggi 2-4.
Apri la macro copiata
- Se non è già aperto, apri il foglio di lavoro in cui hai copiato la macro.
- Fai clic su Estensioni > Apps Script.
- Se non vedi il progetto Apps Script copiato, assicurati che L'API Google Apps Script è attivata nella dashboard impostazioni e ripeti i passaggi elencati in Copiare la macro.
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
UI.gs
appsscript.json
Collaboratori
Questo campione è gestito da Google con l'aiuto degli Esperti Google Developers.
Passaggi successivi
- Estendi Google Workspace con i componenti aggiuntivi
- Crea componenti aggiuntivi di Google Workspace
- Pubblicare un'app