Acl: insert

Crea una regola di controllo dell'accesso. Prova subito.

Richiesta

Richiesta HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

Parametri

Nome parametro Valore Descrizione
Parametri del percorso
calendarId string Identificatore del calendario. Per recuperare gli ID dei calendari, chiama il metodo calendarList.list. Se vuoi accedere al calendario principale dell'utente attualmente connesso, utilizza la parola chiave "primary".
Parametri di query facoltativi
sendNotifications boolean Indica se inviare notifiche in merito alla modifica della condivisione del calendario. Facoltativo. Il valore predefinito è True.

Autorizzazione

Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti:

Ambito
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

Per saperne di più, consulta la pagina relativa all'autenticazione e all'autorizzazione.

Corpo della richiesta

Nel corpo della richiesta, fornisci una risorsa Acl con le seguenti proprietà:

Nome proprietà Valore Descrizione Note
Proprietà obbligatorie
role string Il ruolo assegnato all'ambito. I valori possibili sono:
  • "none" - Non fornisce alcun accesso.
  • "freeBusyReader" - Fornisce l'accesso in lettura alle informazioni sulla disponibilità.
  • "reader" - Fornisce l'accesso in lettura al calendario. Gli eventi privati verranno visualizzati dagli utenti con accesso in lettura, ma i dettagli degli eventi saranno nascosti.
  • "writerWithoutPrivateAccess" - Fornisce l'accesso in lettura e scrittura al calendario. Gli eventi privati verranno visualizzati dagli utenti con accesso writerWithoutPrivateAccess, ma i dettagli degli eventi saranno nascosti.
  • "writer" - Fornisce l'accesso in lettura e scrittura al calendario. Gli eventi privati verranno visualizzati dagli utenti con accesso in scrittura e i dettagli degli eventi saranno visibili. Fornisce l'accesso in lettura agli ACL del calendario.
  • "owner" - Fornisce l'accesso di amministratore al calendario. Questo ruolo ha tutte le autorizzazioni del ruolo di scrittore con la possibilità aggiuntiva di modificare i livelli di accesso di altri utenti.

scrivibile
scope object La misura in cui l'accesso al calendario viene concesso da questa regola ACL.
scope.type string Il tipo di ambito. I valori possibili sono:
  • "default" \- L'ambito pubblico. Questo è il valore predefinito.
  • "user" - Limita l'ambito a un singolo utente.
  • "group" - Limita l'ambito a un gruppo.
  • "domain" \- Limita l'ambito a un dominio.
Nota: le autorizzazioni concesse all'ambito "default" o pubblico si applicano a qualsiasi utente, autenticato o meno.
Proprietà facoltative
scope.value string L'indirizzo email di un utente o di un gruppo o il nome di un dominio, a seconda del tipo di ambito. Omesso per il tipo "default". scrivibile

Risposta

Se l'operazione ha esito positivo, questo metodo restituisce una risorsa Acl nel corpo della risposta.

Prova

Utilizza l'Esplora API di seguito per chiamare questo metodo sui dati live e visualizzare la risposta.