Abilitazione dell'autorizzazione e dell'accesso degli script

L'API Apps Script richiede tipi diversi di autorizzazioni a seconda dell'obiettivo:

  • Utilizza l'API Apps Script nella tua app.
  • Consenti ad altre applicazioni di gestire i deployment o i dati del progetto di script.

Se devi utilizzare l'API Apps Script nell'applicazione, devi enable l'API nel progetto Google Cloud dell'applicazione. Ciò consente di creare credenziali OAuth in modo che gli utenti dell'applicazione possano autorizzarla.

Se vuoi consentire ad applicazioni di terze parti di gestire i contenuti o il deployment dei progetti di script, devi concedere l'accesso a questi ultimi.

Utilizzare l'API Apps Script nella tua app

Se vuoi utilizzare l'API Apps Script nell'app, devi abilitarla nel progetto Google Cloud dell'applicazione. Dopo aver abilitato l'API Apps Script, puoi creare le credenziali OAuth e scaricare l'ID client e il secret da includere nell'applicazione. Puoi anche monitorare l'utilizzo dell'API nella console Google Cloud.

Puoi utilizzare questa procedura guidata per creare o selezionare un progetto Google Cloud nella console API e abilitare automaticamente l'API. In alternativa, puoi aprire la pagina Gestisci risorse della console, selezionare un progetto, quindi cercare e aggiungere manualmente l'API Apps Script utilizzando la dashboard API e servizi del progetto. Una volta abilitata l'API, puoi creare le credenziali OAuth, gli ID client e i client secret per le tue applicazioni nel riquadro API e servizi > Credenziali.

Le guide rapide dell'API Apps Script forniscono una panoramica dettagliata dell'intero processo di abilitazione dell'API e di configurazione dell'autorizzazione per un'applicazione.

Concedere ad applicazioni di terze parti l'accesso ai tuoi progetti di script

L'API Apps Script può consentire alle applicazioni di creare e modificare i tuoi script e i relativi deployment. Ciò può portare a una situazione negativa se autorizzi un'applicazione di terze parti dannosa, che quindi procede a creare script più dannosi o a modificare il comportamento degli script già in tuo possesso.

Per ridurre questo rischio, l'API Apps Script non può accedere ai tuoi progetti di script per impostazione predefinita. Devi concedere esplicitamente l'accesso all'API prima di poter utilizzare qualsiasi applicazione in grado di creare o modificare script o deployment. Una volta concesso all'API l'accesso agli script, le applicazioni autorizzate potranno utilizzare l'API per gestire i tuoi progetti di script.

Se provi a eseguire un'applicazione interessata senza prima concedere l'accesso all'API, si verifica un errore. Questo errore si verifica dopo aver autorizzato l'applicazione.

Puoi concedere all'API Apps Script l'accesso ai tuoi progetti di script utilizzando la dashboard di Apps Script. Puoi anche utilizzare la dashboard per revocare l'accesso in qualsiasi momento. Se concedi l'accesso all'API, lo fai per tutte le applicazioni. Tuttavia, le applicazioni individuali devono comunque essere autorizzate.

Prima di concedere l'accesso, assicurati di comprendere che esiste un rischio nel consentire alle applicazioni di modificare i tuoi script. Non autorizzare mai le applicazioni che sospetti siano dannose.