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 del 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 Calendari 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 specificate, sovrascrive le proprietà dell'etichetta esistenti. Se non specificate, le proprietà dell'etichetta rimangono invariate. scrivibile
labelProperties.eventLabels[] list Etichette di evento definite in questo calendario. Se è presente durante l'aggiornamento del calendario, sostituirà le etichette degli eventi esistenti.

Estendi l'elenco per aggiungere una nuova etichetta per gli eventi 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 inserisci una nuova etichetta. Se non viene fornito, verrà generato un ID univoco. Obbligatorio quando viene aggiornata 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 La posizione geografica del calendario come testo in formato libero. Facoltativo. scrivibile
summary string Il titolo del calendario. scrivibile
timeZone string Il fuso orario del calendario. (Formattato come nome del database dei fusi orari IANA, ad es. "Europe/Zurich".) Facoltativo. scrivibile

Risposta

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

Prova

Utilizza Explorer API riportato di seguito per chiamare questo metodo sui dati live e visualizzare la risposta.