Calendars

Collection de tous les agendas existants. Consultez également Agendas et CalendarList.

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}
Nom de propriété Valeur Description Remarques
conferenceProperties nested object Propriétés de visioconférence pour cet agenda, par exemple les types de visioconférences autorisés.
conferenceProperties.allowedConferenceSolutionTypes[] list Types de solutions de visioconférence compatibles avec cet agenda.

Les valeurs possibles sont :

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
 Facultatif.

dataOwner string Adresse e-mail du propriétaire de l'agenda. Défini uniquement pour les agendas secondaires. Lecture seule.
description string Description de l'agenda. Facultatif. accessible en écriture
etag etag ETag de la ressource.
id string Identifiant de l'agenda. Pour récupérer les ID, appelez la méthode calendarList.list().
kind string Type de la ressource ("calendar#calendar").
location string Emplacement géographique de l'agenda sous forme de texte libre. Facultatif. accessible en écriture
summary string Titre de l'agenda. accessible en écriture
timeZone string Fuseau horaire de l'agenda. (Formaté comme un nom de la base de données des fuseaux horaires IANA, par exemple "Europe/Zurich".) Facultatif. accessible en écriture

Méthodes

clair
Efface un agenda principal. Cette opération supprime tous les événements associés à l'agenda principal d'un compte.
supprimer
Supprime un agenda secondaire. Utilisez calendars.clear pour effacer tous les événements des agendas principaux.
get
Affiche les métadonnées d'un agenda.
insérer
Crée un agenda secondaire.

L'utilisateur authentifié pour la requête devient le propriétaire des données du nouvel agenda.

patch
Met à jour les métadonnées d'un agenda. Cette méthode est compatible avec la sémantique "patch". Notez que chaque requête PATCH consomme trois unités de quota. Il est préférable d'utiliser un get suivi d'un update. Les valeurs de champ que vous spécifiez remplacent les valeurs existantes. Les champs que vous ne spécifiez pas dans la requête restent inchangés. Si des champs de tableau sont spécifiés, ils écrasent les tableaux existants, ce qui supprime tous les éléments de tableau précédents.
update
Met à jour les métadonnées d'un agenda.