Calendars

Una raccolta di tutti i calendari esistenti. Vedi anche Calendari e CalendarList.

Per un elenco dei metodi per questa risorsa, vedi la fine di questa pagina.

Rappresentazioni delle risorse

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "labelProperties": {
    "eventLabels": [
      {
        "id": string,
        "backgroundColor": string,
        "name": string
      }
    ]
  },
  "autoAcceptInvitations": boolean
}
Nome proprietà Valore Descrizione Note
autoAcceptInvitations boolean Indica se questo calendario accetta automaticamente gli inviti. Valido solo per i calendari delle risorse.
conferenceProperties nested object Proprietà di videoconferenza per questo calendario, ad esempio i tipi di conferenze consentiti.
conferenceProperties.allowedConferenceSolutionTypes[] list I tipi di soluzioni per videoconferenze supportati per questo calendario.

I valori possibili sono:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
Facoltativo.
dataOwner string L'indirizzo email del proprietario del calendario. Impostato solo per i calendari secondari. Sola lettura.
description string Descrizione del calendario. Facoltativo. Scrivibile
etag etag ETag della risorsa.
id string Identificatore del calendario. Per recuperare gli ID, chiama il metodo calendarList.list().
kind string Il tipo di risorsa ("calendar#calendar").
labelProperties nested object Proprietà delle etichette definite in questo calendario. Se specificate, sovrascrivono le proprietà delle etichette esistenti. Se non specificate, le proprietà delle etichette rimangono invariate. Scrivibile
labelProperties.eventLabels[] list Etichette degli eventi 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 dell'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 Il 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 Il nome dell'etichetta. Facoltativo.

Se fornito, deve avere 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

Metodi

clear
Cancella un calendario principale. Questa operazione elimina tutti gli eventi associati al calendario principale di un account.
delete
Elimina un calendario secondario. Utilizza calendars.clear per cancellare tutti gli eventi sui calendari principali.
get
Restituisce i metadati di un calendario.
insert
Crea un calendario secondario.

L'utente autenticato per la richiesta diventa il proprietario dei dati del nuovo calendario.

patch
Aggiorna i metadati di un calendario. Questo metodo supporta la semantica delle patch. Tieni presente che ogni richiesta di patch consuma tre unità di quota; è preferibile utilizzare un get seguito da un update. I valori dei campi specificati sostituiscono i valori esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti; in questo modo vengono eliminati tutti gli elementi array precedenti.
transferOwnership
Trasferisce un calendario secondario tra gli utenti di un'organizzazione Google Workspace. Richiede l'autenticazione dell'utente con il privilegio di amministratore Gestisci calendari e uno dei seguenti ambiti di autorizzazione:
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
Nella richiesta, imposta useAdminAccess su true. Il calendario secondario deve essere attivo per essere trasferito. Il trasferimento di calendari disattivati o eliminati non è supportato.
update
Aggiorna i metadati di un calendario.