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.

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 account di servizio per l'autenticazione. Se utilizzi un account di servizio per l'autenticazione, l'account di servizio è il proprietario dei dati, il che può portare a un comportamento imprevisto. Ad esempio, se un account di servizio è 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; è 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.