Calendars

Collection de tous les agendas existants. Consultez également Calendars vs 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
    ]
  },
  "labelProperties": {
    "eventLabels": [
      {
        "id": string,
        "backgroundColor": string,
        "name": string
      }
    ]
  },
  "autoAcceptInvitations": boolean,
  "workingHours": {
    "workingHoursEnabled": boolean,
    "availableTimes": [
      {
        "dayOfWeek": string,
        "periodStart": integer,
        "periodEnd": integer
      }
    ]
  }
}

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

Renvoie 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 de correctif consomme trois unités de quota. Privilégiez l'utilisation d'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, ce qui supprime tous les éléments de tableau précédents.

transferOwnership

Transfère un agenda secondaire d'un utilisateur à un autre dans une organisation Google Workspace. Nécessite l'authentification de l'utilisateur avec le droit d'administrateur Gérer les agendas et l'un des champs d'application d'autorisation suivants :

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.calendars

Dans la requête, définissez useAdminAccess sur true. L'agenda secondaire doit être actif pour être transféré. Le transfert d'agendas désactivés ou supprimés n'est pas possible.

update

Met à jour les métadonnées d'un agenda.