Calendars
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ensemble de tous les agendas existants. Consultez également la page 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,
"conferenceProperties": {
"allowedConferenceSolutionTypes": [
string
]
}
}
Nom de propriété |
Valeur |
Description |
Remarques |
conferenceProperties |
nested object |
Propriétés de conférence de cet agenda, par exemple les types de conférences autorisés. |
|
conferenceProperties.allowedConferenceSolutionTypes[] |
list |
Types de solutions de conférence compatibles avec cet agenda. Les valeurs possibles sont : "eventHangout" "eventNamedHangout" "hangoutsMeet" Facultatif. |
|
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 au format libre Facultatif. |
accessible en écriture
|
summary |
string |
Titre de l'agenda. |
accessible en écriture
|
timeZone |
string |
Fuseau horaire de l'agenda. (présenté sous la forme d'un nom de base de données des fuseaux horaires de l'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 calendar.clear pour effacer tous les événements des agendas principaux.
- get
- Renvoie les métadonnées d'un agenda.
- insérer
- Crée un agenda secondaire.
- 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. utilisez plutôt 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. Les champs de tableau, s'ils sont spécifiés, écrasent les tableaux existants. tous les éléments du tableau précédents sont supprimés.
- mise à jour
- Met à jour les métadonnées d'un agenda.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# Calendars\n\nA collection of all existing calendars. See also [Calendars vs CalendarList](/workspace/calendar/api/concepts/events-calendars#calendar_and_calendar_list).\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"calendar#calendar\",\n \"etag\": etag,\n \"id\": string,\n \"summary\": string,\n \"description\": string,\n \"location\": string,\n \"timeZone\": string,\n \"conferenceProperties\": {\n \"allowedConferenceSolutionTypes\": [\n string\n ]\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `conferenceProperties` | `nested object` | Conferencing properties for this calendar, for example what types of conferences are allowed. | |\n| conferenceProperties.`allowedConferenceSolutionTypes[]` | `list` | The types of conference solutions that are supported for this calendar. The possible values are: - `\"eventHangout\"` - `\"eventNamedHangout\"` - `\"hangoutsMeet\"` Optional. \u003cbr /\u003e | |\n| `description` | `string` | Description of the calendar. Optional. | writable |\n| `etag` | `etag` | ETag of the resource. | |\n| `id` | `string` | Identifier of the calendar. To retrieve IDs call the [calendarList.list()](/calendar/v3/reference/calendarList/list) method. | |\n| `kind` | `string` | Type of the resource (\"`calendar#calendar`\"). | |\n| `location` | `string` | Geographic location of the calendar as free-form text. Optional. | writable |\n| `summary` | `string` | Title of the calendar. | writable |\n| `timeZone` | `string` | The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. \"Europe/Zurich\".) Optional. | writable |\n\nMethods\n-------\n\n[clear](/workspace/calendar/api/v3/reference/calendars/clear)\n: Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account.\n\n[delete](/workspace/calendar/api/v3/reference/calendars/delete)\n: Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.\n\n[get](/workspace/calendar/api/v3/reference/calendars/get)\n: Returns metadata for a calendar.\n\n[insert](/workspace/calendar/api/v3/reference/calendars/insert)\n: Creates a secondary calendar.\n\n[patch](/workspace/calendar/api/v3/reference/calendars/patch)\n: Updates metadata for a calendar. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n\n[update](/workspace/calendar/api/v3/reference/calendars/update)\n: Updates metadata for a calendar."]]