Scegli gli ambiti dell'API Google Calendar

Questo documento contiene informazioni su autorizzazione e autenticazione specifiche per l'API Google Calendar. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace all'indirizzo Scopri di più su autenticazione e autorizzazione.

Configurare OAuth 2.0 per l'autorizzazione

Configurare la schermata per il consenso OAuth e scegliere gli ambiti per definire le informazioni da mostrare agli utenti e ai revisori dell'app e registrare la tua app in modo da poterla pubblicare in un secondo momento.

Ambiti dell'API Calendar

Per definire il livello di accesso concesso alla tua app, devi identificare e dichiarare gli ambiti di autorizzazione. Un ambito di autorizzazione è una stringa URI OAuth 2.0 che contiene il nome dell'app Google Workspace, il tipo di dati a cui accede e il livello di accesso. Gli ambiti sono le richieste dell'app per lavorare con i dati di Google Workspace, inclusi i dati dell'Account Google degli utenti.

Quando l'app è installata, a un utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, devi scegliere l'ambito più limitato possibile ed evitare di richiedere ambiti non necessari per la tua app. Gli utenti acconsentono più facilmente all'accesso ad ambiti limitati e descritti chiaramente.

Se la tua applicazione pubblica utilizza ambiti che consentono l'accesso a determinati dati utente, deve completare una procedura di verifica. Se sullo schermo viene visualizzata la dicitura App non verificata durante il test dell'applicazione, devi inviare una richiesta di verifica per rimuoverla. Scopri di più sulle app non verificate e trova le risposte alle domande frequenti sulla verifica delle app nel Centro assistenza.

L'API Calendar supporta i seguenti ambiti:

Ambito	Significato
https://www.googleapis.com/auth/calendar	Visualizzare, modificare, condividere ed eliminare definitivamente tutti i calendari a cui hai accesso con Google Calendar.
https://www.googleapis.com/auth/calendar.readonly	Visualizzare e scaricare qualsiasi calendario a cui hai accesso con il tuo calendario.
https://www.googleapis.com/auth/calendar.freebusy	Visualizzare la tua disponibilità nei tuoi calendari.
https://www.googleapis.com/auth/calendar.events	Visualizzare e modificare gli eventi in tutti i tuoi calendari.
https://www.googleapis.com/auth/calendar.events.readonly	Visualizzare gli eventi in tutti i tuoi calendari.
https://www.googleapis.com/auth/calendar.settings.readonly	Visualizza le impostazioni di Calendar.
https://www.googleapis.com/auth/calendar.addons.execute	Eseguire come componente aggiuntivo di Calendar.
https://www.googleapis.com/auth/calendar.addons.current.event.read	Visualizzare gli eventi aperti in Google Calendar.
https://www.googleapis.com/auth/calendar.addons.current.event.write	Modificare gli eventi aperti in Google Calendar.
https://www.googleapis.com/auth/calendar.events.owned	Visualizzare, creare, modificare ed eliminare eventi nei calendari Google di tua proprietà.
https://www.googleapis.com/auth/calendar.events.owned.readonly	Visualizzare gli eventi nei calendari Google di tua proprietà.
https://www.googleapis.com/auth/calendar.events.freebusy	Visualizzare la disponibilità nei calendari Google a cui hai accesso.
https://www.googleapis.com/auth/calendar.app.created	Creare calendari Google secondari e visualizzare, creare, modificare ed eliminare eventi in questi.
https://www.googleapis.com/auth/calendar.calendarlist	Visualizzare, aggiungere e rimuovere i calendari Google a cui hai effettuato l'iscrizione.
https://www.googleapis.com/auth/calendar.calendarlist.readonly	Visualizza l'elenco dei calendari Google a cui hai effettuato l'iscrizione.
https://www.googleapis.com/auth/calendar.calendars	Visualizzare e modificare le proprietà dei calendari Google a cui hai accesso e creare calendari secondari.
https://www.googleapis.com/auth/calendar.calendars.readonly	Visualizzare il titolo, la descrizione, il fuso orario predefinito e altre proprietà dei calendari Google a cui hai accesso.
https://www.googleapis.com/auth/calendar.acls	Visualizzare e modificare le autorizzazioni di condivisione dei calendari Google di tua proprietà.
https://www.googleapis.com/auth/calendar.acls.readonly	Visualizzare le autorizzazioni di condivisione dei calendari Google di tua proprietà.
https://www.googleapis.com/auth/calendar.events.public.readonly	Visualizzare gli eventi nei calendari pubblici.