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
    ]
  },
  "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").
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 utenti all'interno 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.