CalendarList: insert

Inserisce un calendario esistente nell'elenco dei calendari dell'utente. Prova subito.

Richiesta

Richiesta HTTP

POST https://www.googleapis.com/calendar/v3/users/me/calendarList

Parametri

Nome parametro Valore Descrizione
Parametri di query facoltativi
colorRgbFormat boolean Indica se utilizzare i campi foregroundColor e backgroundColor per scrivere i colori del calendario (RGB). Se viene utilizzata questa funzionalità, il campo colorId basato sull'indice verrà impostato automaticamente sull'opzione di corrispondenza migliore. Facoltativo. Il valore predefinito è False.

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.calendarlist

Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.

Corpo della richiesta

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

Nome proprietà Valore Descrizione Note
Proprietà obbligatorie
id string Identificatore del calendario.
Proprietà facoltative
backgroundColor string Il colore principale del calendario nel formato esadecimale "#0088aa". Questa proprietà sostituisce la proprietà colorId basata sull'indice. Per impostare o modificare questa proprietà, devi specificare colorRgbFormat=true nei parametri dei metodi insert, update e patch. Facoltativo. scrivibile
colorId string Il colore del calendario. Si tratta di un ID che fa riferimento a una voce nella sezione calendar della definizione dei colori (vedi l'endpoint colors). Questa proprietà è sostituita dalle proprietà backgroundColor e foregroundColor e può essere ignorata quando le utilizzi. Facoltativo. scrivibile
defaultReminders[] list I promemoria predefiniti dell'utente autenticato per questo calendario. scrivibile
defaultReminders[].method string Il metodo utilizzato da questo promemoria. I valori possibili sono:
  • "email": i promemoria vengono inviati via email.
  • "popup": i promemoria vengono inviati tramite un popup dell'interfaccia utente.

Obbligatorio quando aggiungi un promemoria.

 scrivibile
defaultReminders[].minutes integer Numero di minuti prima dell'inizio dell'evento in cui deve essere attivato il promemoria. I valori validi sono compresi tra 0 e 40320 (4 settimane in minuti).

Obbligatorio quando aggiungi un promemoria.

 scrivibile
foregroundColor string Il colore di primo piano del calendario nel formato esadecimale "#ffffff". Questa proprietà sostituisce la proprietà colorId basata sull'indice. Per impostare o modificare questa proprietà, devi specificare colorRgbFormat=true nei parametri dei metodi insert, update e patch. Facoltativo. scrivibile
hidden boolean Indica se il calendario è stato nascosto dall'elenco. Facoltativo. L'attributo viene restituito solo quando il calendario è nascosto, nel qual caso il valore è true. scrivibile
notificationSettings object Le notifiche che l'utente autenticato riceve per questo calendario. scrivibile
notificationSettings.notifications[].method string Il metodo utilizzato per inviare la notifica. Il valore possibile è:
  • "email": le notifiche vengono inviate via email.

Obbligatorio quando aggiungi una notifica.

 scrivibile
notificationSettings.notifications[].type string Il tipo di notifica. I valori possibili sono:
  • "eventCreation": notifica inviata quando un nuovo evento viene inserito nel calendario.
  • "eventChange": notifica inviata quando viene modificato un evento.
  • "eventCancellation": notifica inviata quando un evento viene annullato.
  • "eventResponse": notifica inviata quando un partecipante risponde all'invito all'evento.
  • "agenda": un programma con gli eventi della giornata (inviato al mattino).

Obbligatorio quando aggiungi una notifica.

 scrivibile
selected boolean Indica se i contenuti del calendario vengono visualizzati nell'interfaccia utente del calendario. Facoltativo. Il valore predefinito è False. scrivibile
summaryOverride string Il riepilogo impostato dall'utente autenticato per questo calendario. Facoltativo. scrivibile

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa CalendarList nel corpo della risposta.

Prova

Utilizza l'Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.