Calendars: update

Aggiorna i metadati di un calendario. Prova subito.

Richiesta

Richiesta HTTP

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

Parametri

Nome parametro Valore Descrizione
Parametri di percorso
calendarId string Identificatore del calendario. Per recuperare gli ID calendario, chiama il metodo calendarList.list. Se vuoi accedere al calendario principale dell'utente attualmente connesso, utilizza la parola chiave "primary".

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.app.created
https://www.googleapis.com/auth/calendar.calendars

Per saperne di più, consulta la pagina Autenticazione e autorizzazione.

Corpo della richiesta

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

Nome proprietà Valore Descrizione Note
Proprietà facoltative
description string Descrizione del calendario. Facoltativo. scrivibile
labelProperties nested object Proprietà delle etichette definite in questo calendario. Se specificato, sovrascrive le proprietà dell'etichetta esistente. Se non specificato, le proprietà dell'etichetta rimangono invariate. scrivibile
labelProperties.eventLabels[] list Etichette degli eventi definite in questo calendario. Se questo campo è presente durante l'aggiornamento del calendario, sostituirà le etichette degli eventi esistenti.

Estendi l'elenco per aggiungere una nuova etichetta evento e rimuovi le entità dall'elenco per eliminare un'etichetta dal calendario.

Ogni calendario può avere un massimo di 200 etichette.

 scrivibile
labelProperties.eventLabels[].backgroundColor string Colore di sfondo dell'etichetta in formato esadecimale, ad esempio "#039be5". Gli eventi con questa etichetta vengono visualizzati in questo colore. Obbligatorio. scrivibile
labelProperties.eventLabels[].id string L'ID dell'etichetta. Facoltativo quando si inserisce una nuova etichetta. Se non viene fornito, verrà generato un ID univoco. Obbligatorio quando si aggiorna un'etichetta.

Se fornito, l'ID deve essere univoco all'interno del calendario e seguire il formato UUID.

 scrivibile
labelProperties.eventLabels[].name string Nome dell'etichetta. Facoltativo.

Se fornito, deve contenere al massimo 50 caratteri.

 scrivibile
location string Posizione geografica del calendario come testo in formato libero. Facoltativo. scrivibile
summary string Titolo del calendario. scrivibile
timeZone string Il fuso orario del calendario. (Formattato come nome del database dei fusi orari IANA, ad esempio "Europe/Zurich".) Facoltativo. scrivibile
workingHours object Rappresenta le informazioni sull'orario di lavoro dell'utente. Disponibile solo per i calendari principali degli utenti di Google Workspace. Per aggiornare l'orario di lavoro, è necessario passare l'intero oggetto dell'orario di lavoro. Se non specificato (o se viene passato come null o un oggetto vuoto), l'orario di lavoro esistente rimane invariato. Per disattivare l'orario di lavoro o cancellare la programmazione, imposta workingHoursEnabled su false (e ometti availableTimes o passa un elenco vuoto). scrivibile
workingHours.availableTimes[] list Orario di lavoro. Ogni periodo di disponibilità rappresenta il blocco dell'orario di lavoro dell'utente durante un giorno. scrivibile
workingHours.availableTimes[].dayOfWeek string Giorno della settimana. Obbligatorio. I valori possibili sono:
  • "monday"
  • "tuesday"
  • "wednesday"
  • "thursday"
  • "friday"
  • "saturday"
  • "sunday"
scrivibile
workingHours.availableTimes[].periodEnd integer Fine del periodo, in minuti dall'inizio della giornata, esclusa. Obbligatorio. scrivibile
workingHours.availableTimes[].periodStart integer Inizio del periodo, in minuti dall'inizio del giorno, inclusi. Obbligatorio. scrivibile
workingHours.workingHoursEnabled boolean Indica se l'orario di lavoro è abilitato per questo calendario. Non può essere impostato su true quando availableTimes è vuoto. scrivibile

Risposta

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

Prova

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