Ogni progetto Apps Script utilizza Google Cloud per gestire le autorizzazioni, servizi avanzati e altri dettagli. Per configurare e gestire queste impostazioni, ogni progetto Apps Script dispone di un progetto Google Cloud associato. Il progetto di script può utilizzare un oggetto progetto predefinito che Apps Script o vengono creati automaticamente progetto standard creato da te per te. In generale, i progetti predefiniti sono ideali per le attività di tutti i giorni o semplici ma dovresti usare un progetto standard per qualsiasi applicazione che è 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 indietro per utilizzare un progetto predefinito. È meglio per selezionare il progetto Cloud usato dallo script nelle prime fasi di sviluppo. Il passaggio in un secondo momento può causare complicazioni, ad esempio richiedere agli utenti di autorizza di nuovo.
Progetti Cloud predefiniti
Quando crei un progetto Apps Script, Apps Script crea un oggetto progetto cloud che opera in background.
- Per la maggior parte degli script, non è mai necessario visualizzare o modificare questo progetto predefinito. App Lo script gestisce le interazioni necessarie con Google Cloud. Ad esempio, se attivi un servizio avanzato nell'editor di Apps Script, attiva il servizio avanzato nel progetto Cloud predefinito quando salvare il progetto dello script.
- Per alcuni script, devi interagire con la console Google Cloud. In queste in altri casi, lo script deve usare un progetto Cloud standard. Per Ad esempio, per visualizzare i log di Google Cloud nella console Google Cloud, lo script deve utilizzare di un progetto standard.
Per impostazione predefinita, i progetti Cloud dispongono di un servizio Identity and Access Management
(IAM) con una sola voce, un account di servizio Google che agisce come proprietario di
il progetto predefinito. L'account di servizio Google è
appsdev-apps-dev-script-auth@system.gserviceaccount.com
.
Visualizza o aggiorna i progetti Cloud predefiniti
La maggior parte degli utenti non può individuare, visualizzare o modificare direttamente i progetti predefiniti nella nella console Google Cloud. Se sei un amministratore, consulta Visualizzare i progetti Google Cloud predefiniti.
Se hai creato il progetto di script prima dell'8 aprile 2019, puoi utilizzare una progetto predefinito a cui puoi accedere nella console Google Cloud. Per accedere al progetto predefinito, vai alle impostazioni del progetto di script e fai clic sul progetto numero.
Elimina progetti Cloud predefiniti
Se sei un amministratore, puoi eliminare i progetti Cloud predefiniti come faresti progetti Cloud standard. Vedi Eliminare i progetti Cloud Apps Script.
Se non sei un amministratore, non puoi eliminare i progetti predefiniti. Tuttavia, Apps Script elimina i progetti predefiniti nei seguenti scenari:
- Se elimini il progetto di script o lo cambi per utilizzare un progetto standard, Lo script elimina il progetto predefinito allegato allo script insieme a eventuali impostazioni o alle informazioni che contiene.
- Se uno script non viene eseguito per 180 giorni o più, Apps Script elimina il progetto predefinito associato. Se lo script viene eseguito dopo Apps Script elimina il suo progetto predefinito, Apps Script ne crea uno per lo script.
Progetti Cloud standard
I progetti Cloud predefiniti sono l'opzione migliore per la maggior parte dei progetti di script, a meno che tu non debba configurare il progetto manualmente. In queste situazioni, è necessario cambiare il progetto di script in modo che utilizzi un progetto standard.
Le seguenti sezioni descrivono quando Apps Script richiede un progetto standard, le proprietà di questi progetti e le attività comuni che li svolgono. Puoi solo di eseguire le attività riportate di seguito con i progetti standard.
Quando Apps Script richiede progetti Cloud standard
Devi utilizzare un progetto standard nelle seguenti situazioni:
- Per pubblicare il progetto di script come componente aggiuntivo in Google Workspace Marketplace.
- Verificare il client OAuth del progetto di script.
- Se hai un'applicazione che deve eseguire funzioni nel tuo
utilizzando
Metodo
scripts.run
dell'API Apps Script. - Per visualizzare lo script i log di Google Cloud Console Google Cloud. La console Google Cloud offre più strumenti per filtrare e di visualizzare i log e può essere più utile rispetto alla visualizzazione semplificata offerta la dashboard di Apps Script.
- Per visualizzare i report sugli errori del progetto di script utilizzando Error Reporting.
- Per creare una finestra di dialogo di apertura file.
- Quando altrimenti hai bisogno del controllo manuale Impostazioni di Google Cloud.
Proprietà del progetto Cloud standard
I progetti standard hanno le seguenti proprietà:
- Puoi accedere direttamente a tutte le impostazioni di Google Cloud per il progetto dalla console Google Cloud. Ciò ti consente di attivare le API, regolare le autorizzazioni le credenziali e configurare altri dettagli.
- Quando elimini un progetto di script o lo passi a utilizza un altro progetto standard, il progetto standard originale rimane e può essere riutilizzate.
- Quando attivi un servizio avanzato in un progetto di script, devi attivare manualmente l'API corrispondente nella progetto standard.
- Più progetti di script e altre app possono condividere lo stesso progetto standard. Se intendi pubblicare un progetto di script alle Google Workspace Marketplace come componente aggiuntivo, deve avere un proprio progetto standard. Le app pubblicate non possono essere condivise progetti cloud con altre app.
- Se vuoi eseguire funzioni in un progetto di script da un'altra app utilizzando
il metodo
scripts.run
dell'API Apps Script, il progetto script e l'applicazione chiamante devono condividere lo stesso standard progetto. - Quando Apps Script chiede a un utente di autorizzare uno script che utilizza un modello progetto, il nome del progetto Cloud viene utilizzato per identificare lo script (non il nome del progetto di script). Per questo motivo, assicurati di impostare un'istanza il nome del progetto cloud.
Accedere a un progetto Cloud standard
Per accedere al progetto standard associato allo script procedi nel seguente modo:
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
- In Progetto Google Cloud Platform (Google Cloud), fai clic sul numero di progetto.
Puoi anche trovare un progetto standard direttamente nella pagina Gestisci risorse della console Google Cloud.
Attiva un'API in un progetto Cloud standard
Spesso un'applicazione Apps Script ha bisogno di accedere a un'altra API di Google. Per farlo, devi attivare l'API nel progetto Cloud corrispondente. Attiva un'API seguendo questi passaggi:
- Apri il progetto Cloud.
- Fai clic su Menu > API e Servizi.
- Fai clic su Abilita API e servizi.
- Nella casella di ricerca, inserisci l'API che vuoi attivare e premi Invio.
- Fai clic sull'API nei risultati di ricerca e quindi su Abilita per attivarla l'API per questo progetto Cloud.
Ti potrebbe essere chiesto di accettare i Termini di servizio per API di Google oppure Google Cloud. Leggi i termini del Servizio con attenzione prima di accettarli.
A seconda dell'applicazione, potrebbe anche essere necessario configurare l'API selezionandolo nella sezione API e Services.
Determinare l'ID e numero di progetti Cloud standard
Tutti i progetti Cloud hanno un nome, un ID progetto e un numero di progetto. Occasionalmente, devi avere questi identificatori per configurare i servizi o completare altre attività.
Per determinare l'ID e il numero del tuo progetto standard:
- Apri il progetto Cloud.
- In alto a destra, fai clic su Altro > Impostazioni progetto. .
- Visualizzare il nome del progetto, l'ID del progetto e il numero del progetto nel riquadro Impostazioni visualizzato. Il numero di progetto è composto solo da cifre, mentre l'ID progetto è alfanumerico. Puoi modificare Nome progetto, che viene mostrato agli utenti durante le richieste di autorizzazione.
Visualizza i log di Google Cloud e Report sugli errori nella console Google Cloud
Se utilizzi Google Cloud Logging. o la segnalazione degli errori per il progetto di script, puoi visualizzare i log e i report nel Google Cloud Console seguendo questi passaggi:
- Apri il progetto Cloud.
- Fai clic su Menu .
- Scorri verso il basso fino alla sezione Operazioni. e fai clic su Logging > Esplora log.
- Per visualizzare i report sugli errori, scorri verso il basso fino alla sezione Operazioni. e fai clic su Error Reporting. Se ti viene richiesto di Error Reporting, significa che il progetto di script non ha registrato qualche eccezione.
Completa la schermata per il consenso OAuth
Quando si utilizzano servizi che richiedono OAuth, Google chiede agli utenti di autorizzarli i servizi di machine learning. Le impostazioni della schermata per il consenso OAuth ti consentono di impostare alcune informazioni che Google presenta agli utenti, ad esempio il nome dell'applicazione e l'URL dei Termini di servizio.
I progetti Cloud predefiniti creano automaticamente una schermata per il consenso dal dettagli del progetto Apps Script; non puoi modificare queste impostazioni. I progetti Cloud standard consentono personalizzi queste informazioni. Puoi configurare il consenso del tuo script schermo nel seguente modo:
- Apri il progetto Cloud.
- Fai clic su Menu > API e Servizi > Credenziali.
- Fai clic su Configura schermata per il consenso.
- Compila ogni sezione del flusso di lavoro della schermata per il consenso.
- Per registrare le modifiche in ogni fase del flusso di lavoro, fai clic su Salva e continua.
Crea credenziali OAuth
In genere, Apps Script configura OAuth per i servizi utilizzate dal tuo script. Per alcune applicazioni, è necessario creare altri Credenziali OAuth (ID client e client secret). Puoi eseguire questa operazione solo con per i progetti standard.
Per creare un ID client e un client secret per il tuo progetto di script, segui questi passaggi: seguenti:
- Apri il progetto Cloud.
- Fai clic su Menu > API e Servizi > Credenziali.
- Fai clic su Crea credenziali > ID client OAuth.
- In Tipo di applicazione, seleziona il tipo di applicazione e compilare il modulo risultante, se necessario. Al termine, fai clic su Crea.
- Nella finestra di dialogo visualizzata, fai clic su Scarica JSON. Puoi utilizza questo file per configurare OAuth.
Aggiungi altri proprietari a un progetto Cloud standard
Puoi aggiungere altri proprietari o altri ruoli a un progetto standard. Se stai collaborando a un progetto, questo aiuta a garantire che qualcuno sul tuo il team ha sempre accesso alle impostazioni Google Cloud del progetto di script.
Puoi aggiungere altri proprietari o altri ruoli a un progetto standard eseguendo la seguire. Devi disporre delle autorizzazioni di modifica per consentire al progetto di queste modifiche:
- Determina chi devono essere i tuoi collaboratori. Ti abbiamo consigliato creare o utilizzare un gruppo Google esistente. Puoi e specificare anche i domini nell'elenco dei collaboratori per includere tutti gli utenti dominio.
- Apri il progetto Cloud dello script.
- Fai clic su Menu > IAM e amministratore > IAM.
- In alto, fai clic su Aggiungi.
- Segui le istruzioni sullo schermo per aggiungere uno o più nuovi membri e i loro ruoli al progetto Cloud. Puoi aggiungere singoli indirizzi email, Google Gruppi domini come nuovi membri.
- Fai clic su Salva.
Raggruppa più script con un singolo progetto Cloud
Puoi fare in modo che più progetti Apps Script condividano lo stesso standard progetto cloud. Per farlo, devi creare un progetto standard cambia ogni progetto di script per utilizzarlo. Non puoi eseguire questa operazione con i progetti predefiniti.
Usa un progetto Cloud standard diverso
Puoi cambiare il progetto di uno script in modo che utilizzi uno standard diverso progetto cloud. Se lo script richiede la configurazione manuale del devi passare da un progetto predefinito a uno standard progetto. Per ulteriori informazioni per saperne di più su quando devi utilizzare un progetto standard, consulta progetti Cloud standard.
Effetti del passaggio a un progetto Cloud standard diverso
Se modifichi lo script da un progetto predefinito o a uno standard diverso progetto, avrà i seguenti effetti:
- Se hai attivato i servizi avanzati per lo script, devi attivare il le API corrispondenti nel nuovo progetto Cloud. Perdi tutti i dati associati alla configurazione nel progetto Cloud precedente. Per scoprire come attivare le API Nel tuo progetto Cloud, fai riferimento ad Abilitare le API Google Workspace.
- Se lo script utilizza il servizio integrato di Google Drive, devi attivare il
API Drive nei progetti Cloud standard.
Nel tuo progetto Cloud standard, attiva l'API Drive:
- Tutti gli utenti che hanno autorizzato in precedenza lo script dovranno farlo nuovamente. Nella nella maggior parte dei casi, tutti gli utenti che in precedenza hanno autorizzato le app associate anche il nuovo progetto deve autorizzarlo nuovamente.
- Se lo script è associato a una scheda di app su Google Workspace Marketplace, la scheda, gli utenti e le recensioni non vengono trasferiti nel un nuovo progetto. Devi creare una scheda dell'app all'interno del nuovo progetto e gli utenti devono reinstallare la tua app. Per informazioni sulla creazione di un nuovo sulla scheda dell'app, consulta l'articolo Pubblicare un'app.
- Non puoi riportare uno script a un progetto predefinito. Eliminazioni di Apps Script a progetti predefiniti dopo aver impostato lo script in modo che utilizzi un progetto standard.
Passa a un progetto Cloud standard diverso
Per passare il progetto Cloud esistente di uno script a un altro Google Cloud, segui questi passaggi:
- Se non hai un progetto Cloud adatto, crea uno seguendo la procedura per creare un progetto istruzioni. Imposta un nome facile da ricordare per il progetto nella pagina Gestisci risorse della console Google Cloud. Apps Script utilizza questo nome quando chiedendo agli utenti di autorizzare lo script.
- Se vuoi utilizzare un progetto esistente, apri la pagina Gestisci risorse della console Google Cloud e individuare un progetto esistente da utilizzare. Devi disporre dei Ruoli del Browser di progetto e dell'Editor configurazione OAuth oppure ruoli con l'equivalente autorizzazioni, progetto. Non puoi usare un progetto creato automaticamente da Google Apps Script.
- Determina il numero di progetto del tuo progetto Cloud.
- Apri lo script di cui vuoi sostituire il progetto Cloud.
- A sinistra, fai clic su Impostazioni progetto .
- In Progetto Google Cloud Platform (Google Cloud), fai clic su Cambia progetto.
- Inserisci il nuovo numero di progetto e fai clic su Imposta progetto.
Progetti Cloud e Drive condivisi
I Drive condivisi (in precedenza Drive del team) forniscono spazi condivisi in cui gruppi di utenti di Drive possono collaborare su Apps Script progetti e documenti di Drive. I Drive condivisi sono utili durante lo sviluppo script, componenti aggiuntivi e app web con un team, ma pongono alcune restrizioni cosa puoi fare con i progetti Cloud predefiniti meno recenti.
Il seguente elenco di restrizioni descrive le modalità di interazione dei progetti Cloud con i Drive condivisi:
- Se il progetto di script utilizza un progetto standard, non sono limitazioni aggiuntive se il progetto di script si trova su un Drive condiviso.
- Se il progetto di script utilizza un progetto predefinito creato il giorno dopo l'8 aprile 2019, non ci saranno ulteriori limitazioni quando lo script che il progetto si trova su un Drive condiviso.
- Se il progetto di script utilizza un progetto predefinito creato in precedenza
8 aprile 2019, durante l'utilizzo dello script vengono applicate le seguenti limitazioni
che il progetto si trova su un Drive condiviso:
- Non puoi accedere al progetto predefinito utilizzando l'interfaccia utente di Apps Script o nella console Google Cloud. Questa restrizione ti impedisce di prendere azioni che richiedono l'accesso diretto al progetto.
- Non puoi attivare i servizi avanzati. Per attivare i servizi avanzati, passa a un account standard progetto.
- Quando sposti un progetto Apps Script esistente in un Drive condiviso, Google limita l'accesso al progetto Cloud predefinito. Puoi ancora se disponevi dell'accesso prima dello spostamento. Per un esempio, se hai creato uno script nella cartella Il mio Drive e poi hai spostato in un Drive condiviso, potresti comunque accedere ai progetto cloud. I tuoi collaboratori sul Drive condiviso potrebbero non essere in grado di farlo.
- Uno script conserva il nome del progetto Cloud che aveva prima spostato in su un Drive condiviso. Anche se modifichi il nome del progetto sul Drive condiviso, gli utenti che autorizzano lo script vedono ancora il vecchio nome nell'autorizzazione finestre di dialogo.
Per evitare le suddette limitazioni per gli script meno recenti, passare a un progetto standard.
Visualizza un elenco di progetti Cloud Apps Script
Se disponi dell'autorizzazione resourcemanager.projects.list
per il tuo
cartella del progetto Apps Script dell'organizzazione, puoi visualizzare tutte le
progetti Cloud di Apps Script predefiniti all'interno della cartella.
- Apri la pagina Gestisci risorse della console Google Cloud.
- Copia l'ID accanto alla cartella Apps Script.
- Fai clic su Filtro > ID principale e incolla l'ID della cartella di Apps Script.
Elimina progetti Cloud Apps Script
Per eliminare un progetto Cloud Apps Script, segui i passaggi descritti in Ottenere un di progetti Cloud Apps Script, seleziona il progetto da eliminare e fai clic su Elimina.
Per eliminare un progetto Apps Script utilizzando gcloud
, usa quanto segue
tramite comandi SQL.
gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID
Per ulteriori informazioni sull'eliminazione dei progetti Cloud, consulta Arresto (eliminazione di) progetti.