Progetti Google Cloud

Ogni progetto Google Apps Script utilizza Google Cloud per gestire l'autorizzazione, i servizi avanzati e altri dettagli. Per configurare e gestire queste impostazioni, ogni progetto Apps Script ha un progetto Google Cloud associato. Il progetto dello script può utilizzare un progetto predefinitocreato automaticamente da Apps Script o un progetto standardcreato da te. In genere, i progetti predefiniti sono adatti agli script di uso quotidiano, ma dovresti utilizzare un progetto standard per qualsiasi applicazione complessa, di qualità commerciale o che intendi pubblicare.

Puoi passare da un progetto predefinito a un progetto standard in qualsiasi momento, ma non puoi tornare a utilizzare un progetto predefinito. È consigliabile selezionare il progetto Cloud utilizzato dallo script nelle prime fasi di sviluppo. Se lo fai in un secondo momento, potrebbero verificarsi complicazioni, ad esempio la necessità che gli utenti autorizzino di nuovo.

Progetti Cloud predefiniti

Quando crei un progetto Apps Script, viene creato un progetto Cloud predefinito che opera in background.

  • Per la maggior parte degli script, non è mai necessario visualizzare o modificare questo progetto predefinito. Apps Script gestisce le interazioni necessarie con Google Cloud. Ad esempio, se attivi un servizio avanzato nell'editor di Apps Script, Apps Script lo attiva nel progetto Cloud predefinito quando salvi il progetto dello script.
  • Per alcuni script, devi interagire con la console Google Cloud. In questi casi, lo script deve utilizzare un progetto Cloud standard. Ad esempio, per visualizzare i log di Google Cloud nella console Google Cloud, lo script deve utilizzare un progetto standard.

Per impostazione predefinita, i progetti Cloud hanno un criterio Identity and Access Management (IAM) con una voce, un account di servizio Google che funge da proprietario del progetto predefinito. L'account di servizio Google è appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Visualizzare o aggiornare i progetti Cloud predefiniti

La maggior parte degli utenti non può individuare, visualizzare o modificare direttamente i progetti predefiniti nella console Google Cloud. Se sei un amministratore, consulta Visualizzare i progetti Google Cloud predefiniti.

Se hai creato il progetto dello script prima dell'8 aprile 2019, potresti utilizzare un progetto predefinito a cui puoi accedere nella console Google Cloud. Per accedere al progetto predefinito, vai alle impostazioni del progetto dello script e fai clic sul numero del progetto.

Eliminare i progetti Cloud predefiniti

Se sei un amministratore, puoi eliminare i progetti Cloud predefiniti come faresti con i progetti Cloud standard. Consulta Visualizzare o modificare i progetti Cloud predefiniti.

Gli utenti non amministratori non possono eliminare manualmente i progetti predefiniti. Tuttavia, se elimini il progetto dello script o passi a un progetto standard, Apps Script elimina il progetto predefinito collegato allo script insieme alle relative impostazioni e informazioni.

Progetti Cloud standard

I progetti Cloud predefiniti sono l'opzione migliore per la maggior parte dei progetti di script, a meno che non sia necessario configurare manualmente il progetto. In queste situazioni, devi passare al progetto dello script per utilizzare un progetto standard.

Le sezioni seguenti descrivono quando Apps Script richiede un progetto standard, le relative proprietà e le attività comuni. Esegui queste attività solo con i progetti standard.

Quando Apps Script richiede progetti Cloud standard

Devi utilizzare un progetto standard nelle seguenti situazioni:

Proprietà dei progetti Cloud standard

I progetti standard hanno le seguenti proprietà:

  • Accedi a tutte le impostazioni di Google Cloud per il progetto direttamente dalla console Google Cloud. In questo modo puoi attivare le API, modificare le credenziali di autorizzazione e configurare altri dettagli.
  • Quando elimini un progetto di script o lo passi a un altro progetto standard, il progetto standard originale rimane e può essere riutilizzato.
  • Quando attivi un servizio avanzato in un progetto di script, devi attivare manualmente l'API corrispondente nel progetto standard.
  • Più progetti di script e altre app possono condividere lo stesso progetto standard. Se intendi pubblicare un progetto di script su Marketplace come componente aggiuntivo, deve avere il proprio progetto standard. Le app pubblicate non possono condividere progetti Cloud con altre app.
  • Se vuoi eseguire funzioni in un progetto di script da un'altra app utilizzando il metodo dell'API Apps Scriptscripts.run, il progetto di script e l'applicazione chiamante devono condividere lo stesso progetto standard.
  • Quando Apps Script chiede a un utente di autorizzare uno script che utilizza un progetto standard, il nome del progetto Cloud viene utilizzato per identificare lo script (non il nome del progetto dello script). Per questo motivo, assicurati di impostare un nome di progetto Cloud appropriato.

Accedere a un progetto Cloud standard

Per accedere al progetto standard associato al progetto dello script:

  1. Apri il progetto Apps Script.
  2. A sinistra, fai clic su Impostazioni del progetto .
  3. In Progetto Google Cloud, fai clic sul numero del progetto.

Trova un progetto standard direttamente nella pagina della console Google Cloud Gestisci risorse.

Attivare un'API in un progetto Cloud standard

Per consentire a un'applicazione Apps Script di accedere a un'altra API Google, attiva l'API nel progetto Cloud corrispondente:

  1. Apri il progetto Cloud.
  2. Fai clic su Menu > API e servizi.
  3. Fai clic su Abilita API e servizi.
  4. Nella casella di ricerca, inserisci l'API che vuoi attivare e premi Invio.
  5. Fai clic sull'API nei risultati di ricerca e poi su Abilita.

Potresti ricevere una richiesta di accettare i Termini di servizio delle API Google o di Google Cloud. Leggi attentamente i Termini di servizio prima di accettarli.

A seconda dell'applicazione, potrebbe essere necessario configurare l'API selezionandola nella dashboard API e servizi.

Determinare l'ID e il numero di un progetto Cloud standard

Tutti i progetti Cloud hanno un nome, un ID e un numero. Potresti aver bisogno di questi identificatori per configurare i servizi o completare altre attività.

Per determinare l'ID e il numero del progetto standard:

  1. Apri il progetto Cloud.
  2. In alto a destra, fai clic su Altro > Impostazioni progetto.
  3. Visualizza il Nome del progetto, l'ID progetto e il Numero progetto nel riquadro Impostazioni risultante. Il Numero progetto è composto da cifre, mentre l' ID progetto è alfanumerico. Modifica il Nome del progetto, che viene visualizzato agli utenti durante le richieste di autorizzazione.

Visualizzare i log e i report sugli errori di Google Cloud nella console Google Cloud

Se utilizzi la funzionalità di logging di Google Cloud o di reporting degli errori per il progetto dello script, puoi visualizzare i log e i report nella console Google Cloud procedendo nel seguente modo:

  1. Apri il progetto Cloud.
  2. Fai clic su Menu .
  3. Nella sezione Operazioni, fai clic su Logging > Esplora log.
  4. Per visualizzare i report sugli errori, nella sezione Operazioni , fai clic su Error Reporting. Se ti viene chiesto di configurare Error Reporting, significa che il progetto dello script non ha ancora registrato eccezioni.

Quando utilizzi servizi che richiedono OAuth, Google chiede agli utenti di autorizzare questi servizi. Le impostazioni della schermata per il consenso OAuth definiscono le informazioni che Google presenta agli utenti, come il nome dell'applicazione e l'URL dei Termini di servizio.

I progetti Cloud predefiniti creano automaticamente una schermata per il consenso dai dettagli del progetto Apps Script; non puoi modificare queste impostazioni. I progetti Cloud standard ti consentono di personalizzare queste informazioni. Per configurare la schermata per il consenso dello script:

  1. Apri il progetto Cloud.
  2. Fai clic su Menu > API e servizi > Credenziali.
  3. Fai clic su Configura schermata per il consenso.
  4. Compila ogni sezione del flusso di lavoro della schermata per il consenso.
  5. Per registrare le modifiche in ogni fase, fai clic su Salva e continua.

Creare credenziali OAuth

Apps Script di solito configura OAuth per i servizi utilizzati dallo script. Per alcune applicazioni, crea credenziali OAuth aggiuntive (ID client e secret client). Esegui questa operazione solo con i progetti standard.

Per creare un ID client e un secret client per il progetto dello script:

  1. Apri il progetto Cloud.
  2. Fai clic su Menu > API e servizi > Credenziali.
  3. Fai clic su Crea credenziali > ID client OAuth.
  4. In Tipo di applicazione, seleziona il tipo di applicazione e compila il modulo. Al termine, fai clic su Crea.
  5. Nella finestra di dialogo, fai clic su Scarica JSON. Utilizza questo file per configurare OAuth.

Aggiungere altri proprietari a un progetto Cloud standard

Aggiungi altri proprietari o altri ruoli a un progetto standard per assicurarti che qualcuno del tuo team abbia sempre accesso alle impostazioni di Google Cloud del progetto dello script.

Per aggiungere altri proprietari o altri ruoli a un progetto standard (richiede autorizzazioni di modifica):

  1. Determina i tuoi collaboratori. Ti consigliamo di utilizzare un gruppo Google. Specifica i domini per includere tutti gli utenti del dominio.
  2. Apri il progetto Cloud dello script.
  3. Fai clic su Menu > IAM e amministrazione > IAM.
  4. In alto, fai clic su Aggiungi.
  5. Segui le istruzioni sullo schermo per aggiungere nuovi membri e i relativi ruoli. Aggiungi singoli indirizzi email, gruppi Google o domini.
  6. Fai clic su Salva.

Raggruppare più script con un singolo progetto Cloud

Più progetti Apps Script possono condividere lo stesso progetto Cloud standard. Per farlo, crea un progetto standard e poi passa a ogni progetto di script per utilizzarlo. Non puoi farlo con i progetti predefiniti.

Se vuoi pubblicare il progetto dello script su Marketplace come componente aggiuntivo, deve avere il proprio progetto standard: le app pubblicate non possono condividere progetti Cloud.

Utilizzare un altro progetto Cloud standard

Passa a un progetto di script per utilizzare un altro progetto Cloud standard. Se lo script richiede la configurazione manuale del progetto Cloud, passa da un progetto predefinito a un progetto standard. Per saperne di più, consulta Progetti Cloud standard.

Effetti del passaggio a un altro progetto Cloud standard

Se passi lo script da un progetto predefinito o a un altro progetto standard, si verificano i seguenti effetti:

  • Se hai attivato i servizi avanzati per lo script, devi attivare le API corrispondenti nel nuovo progetto Cloud. Perderai tutti i dati collegati ai servizi avanzati nel progetto Cloud precedente. Per scoprire come attivare le API nel progetto Cloud, consulta Attivare le API Google Workspace.
  • Se lo script utilizza il servizio Google Drive integrato, devi attivare l'API Drive nei progetti Cloud standard.

    Nel progetto Cloud standard, attiva l'API Drive:

    Attivare l'API Drive

  • Tutti gli utenti che hanno autorizzato lo script in precedenza devono autorizzarlo di nuovo. Nella maggior parte dei casi, anche tutti gli utenti che hanno autorizzato in precedenza le app associate al nuovo progetto devono autorizzarle di nuovo.
  • Se lo script è associato a una scheda dell'app in Google Workspace Marketplace, la scheda dell'app, gli utenti e le recensioni non vengono trasferiti al nuovo progetto. Devi creare una scheda dell'app all'interno del nuovo progetto e i tuoi utenti devono reinstallare l'app. Per informazioni sulla creazione di una nuova scheda dell'app, consulta Pubblicare un'app.
  • Non puoi riportare uno script a un progetto predefinito. Apps Script elimina i progetti predefiniti dopo aver impostato lo script in modo che utilizzi un progetto standard.

Passare a un altro progetto Cloud standard

Per passare il progetto Cloud esistente di uno script a un altro progetto Cloud, segui questi passaggi:

  1. Se non hai un progetto Cloud adatto, creane uno seguendo le istruzioni riportate in Creare un progetto. Imposta un nome di progetto memorabile per individuarlo nella console Google Cloud nella pagina Gestisci risorse. Apps Script utilizza questo nome quando chiede agli utenti di autorizzare lo script.
  2. Se vuoi utilizzare un progetto esistente, apri la pagina della console Google Cloud Gestisci risorse e individua un progetto esistente da utilizzare. Devi disporre dei ruoli Project Browser e OAuth Config Editor o di ruoli con le autorizzazioni equivalenti per il progetto. Non puoi utilizzare un progetto creato automaticamente da Apps Script.
  3. Determina il Numero progetto del progetto Cloud.
  4. Apri lo script di cui vuoi sostituire il progetto Cloud.
  5. A sinistra, fai clic su Impostazioni del progetto .
  6. In Progetto Google Cloud, fai clic su Cambia progetto.
  7. Inserisci il nuovo numero di progetto e fai clic su Imposta progetto.

Progetti Cloud e Drive condivisi

I Drive condivisi sono disponibili solo per i clienti di Google Workspace Business e Google Workspace Enterprise.

I Drive condivisi (in precedenza Drive del team) forniscono spazi condivisi in cui i gruppi di utenti di Drive possono collaborare a progetti Apps Script e documenti di Drive. I Drive condivisi sono utili per lo sviluppo di script, componenti aggiuntivi e app web con un team, ma impongono alcune limitazioni a ciò che puoi fare con i progetti Cloud predefiniti precedenti.

L'elenco seguente descrive come i progetti Cloud interagiscono con i Drive condivisi:

  • Se il progetto dello script utilizza un progetto standard, non ci sono ulteriori limitazioni quando il progetto dello script risiede in un Drive condiviso.
  • Se il progetto dello script utilizza un progetto predefinito creato a partire dall'8 aprile 2019, non ci sono ulteriori limitazioni quando il progetto dello script risiede in un Drive condiviso.
  • Se il progetto dello script utilizza un progetto predefinito creato prima dell'8 aprile 2019, si applicano le seguenti limitazioni mentre il progetto dello script risiede in un Drive condiviso:
    1. Non puoi accedere al progetto predefinito utilizzando l'interfaccia utente di Apps Script o la console Google Cloud. Questa limitazione ti impedisce di eseguire azioni che richiedono l'accesso diretto al progetto.
    2. Non puoi attivare i servizi avanzati. Per attivare i servizi avanzati, passa a un progetto standard.
    3. Quando sposti un progetto Apps Script esistente in un Drive condiviso, Google limita l'accesso al progetto Cloud predefinito. Puoi comunque accedere al progetto predefinito se avevi accesso prima dello spostamento. Ad esempio, se hai creato uno script nella cartella Il mio Drive e poi l'hai spostato in un Drive condiviso, puoi comunque accedere al progetto Cloud dello script. I tuoi collaboratori nel Drive condiviso potrebbero non essere in grado di farlo.
    4. Uno script conserva il nome del progetto Cloud che aveva prima di essere spostato in un Drive condiviso. Anche se modifichi il nome del progetto nel Drive condiviso, gli utenti che autorizzano lo script continuano a visualizzare il vecchio nome nelle finestre di dialogo di autorizzazione.

Per evitare queste limitazioni per gli script precedenti, passa a un progetto standard.

Recuperare un elenco di progetti Cloud Apps Script

Se disponi dell'autorizzazione resourcemanager.projects.list per la cartella del progetto Apps Script della tua organizzazione, puoi visualizzare tutti i progetti Cloud Apps Script standard e predefiniti all'interno della cartella.

  1. Apri la pagina della console Google Cloud Gestisci risorse.
  2. Accanto alla cartella Apps Script, copia l'ID.
  3. Fai clic su Filtra > ID parent e incolla l'ID della cartella Apps Script.

Eliminare i progetti Cloud Apps Script

Per eliminare i progetti predefiniti, devi essere un amministratore.

Per eliminare un progetto Apps Script dalla console Google Cloud:

  1. Apri il progetto Cloud.
  2. In alto a destra, fai clic su Altro > Impostazioni progetto.
  3. Fai clic su Arresta / elimina.
  4. Segui le istruzioni sullo schermo per chiudere il progetto.

Per eliminare un progetto Apps Script utilizzando gcloud, utilizza i seguenti comandi.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

Per saperne di più sull'eliminazione dei progetti Cloud, consulta Arrestare (eliminare) i progetti.