Calendars

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

Per un elenco dei metodi per questa risorsa, consulta 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
    ]
  }
}

Nome proprietà	Valore	Descrizione	Note
conferenceProperties	nested object	Proprietà delle conferenze per questo calendario, ad esempio i tipi di conferenze consentiti.
conferenceProperties.allowedConferenceSolutionTypes[]	list	I tipi di soluzioni per conferenze supportati per questo calendario. I valori possibili sono: "eventHangout" "eventNamedHangout" "hangoutsMeet" (Facoltativo)
dataOwner	string	L'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.

elimina

Elimina un calendario secondario. Utilizza calendars.clear per eliminare tutti gli eventi dai 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.

Nota:ti consigliamo di eseguire l'autenticazione come proprietario dei dati previsto del calendario. Puoi utilizzare la delega dell'autorità a livello di dominio per consentire alle applicazioni di agire per conto di un utente specifico. Non utilizzare un service account per l'autenticazione. Se utilizzi un service account per l'autenticazione, il service account è il proprietario dei dati, il che può portare a un comportamento imprevisto. Ad esempio, se un service account è il proprietario dei dati, la proprietà dei dati non può essere trasferita.

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. Ti consigliamo di utilizzare un get seguito da un update. I valori dei campi che specifichi sostituiscono i valori esistenti. I campi non specificati nella richiesta rimangono invariati. I campi array, se specificati, sovrascrivono gli array esistenti, eliminando tutti gli elementi dell'array precedenti.

aggiornamento

Aggiorna i metadati di un calendario.