type de ressource calendar

Espace de noms: microsoft.graph

Représente un conteneur pour les ressources événement. Il peut s’agir du calendrier d’un utilisateur ou du calendrier par défaut d’un groupe Microsoft 365.

Remarque : il existe quelques différences mineures dans la façon dont vous pouvez interagir avec les calendriers des utilisateurs et les calendriers des groupes :

  • Vous pouvez organiser uniquement les calendriers d’utilisateur dans un objet calendarGroup.
  • Outlook accepte automatiquement toutes les demandes de réunion au nom de groupes. Vous pouvez accepter, accepter provisoirement ou refuser les demandes de réunion pour les calendriers utilisateur uniquement.
  • Outlook ne prend en charge les rappels pour les événements de groupe. Vous pouvez répéter ou ignorer un rappel pour les calendriers des utilisateurs uniquement.

Méthodes

Méthode Type renvoyé Description
Répertorier des calendriers collection calendar Obtenez tous les calendriers de l’utilisateur ou les calendriers dans le groupe de calendriers par défaut ou un autre groupe de calendriers spécifique.
Créer un calendrier calendrier Créez un calendrier dans le groupe de calendriers par défaut ou dans un groupe spécifié pour un utilisateur.
Obtenir un calendrier calendrier Récupérez les propriétés et les relations de l’objet de calendrier. Le calendrier peut être celui d’un utilisateur ou du calendrier par défaut d’un groupe Microsoft 365.
Mettre à jour un calendrier calendrier Mettez à jour les propriétés de l’objet de calendrier. Le calendrier peut être celui d’un utilisateur ou du calendrier par défaut d’un groupe Microsoft 365.
Supprimer un calendrier Aucun Supprimez un objet calendar.
Répertorier les affichages de calendrier collection event Obtenez les occurrences, les exceptions et les instances d’événements uniques dans un affichage Calendrier défini par un intervalle de temps, à partir du calendrier principal de l’utilisateur (../me/calendarview) ou d’un calendrier spécifié.
Répertorier des événements collection event Récupérez une liste d’événements dans un calendrier. La liste contient les instances uniques de réunions et les réunions principales des séries.
Créer un événement event Crée un événement dans le calendrier spécifié ou par défaut.
Obtenir le planning de disponibilité collection scheduleInformation Obtenez les informations de disponibilité d’une collection d’utilisateurs, de listes de distributions ou de ressources, correspondant à la période spécifiée.
Rechercher des heures de réunion meetingTimeSuggestionsResult Suggère des heures et des lieux de réunion en fonction de la disponibilité de l’organisateur et des participants, mais aussi des contraintes géographiques et des impératifs de temps.
Créer une propriété à valeur unique calendrier Créez une ou plusieurs propriétés étendues à valeur unique dans un calendrier nouveau ou existant.
Obtenir une propriété à valeur unique calendrier Obtenez des calendriers qui contiennent une propriété étendue à valeur unique à l’aide de $expand ou $filter.
Créer une propriété à valeurs multiples calendrier Créez une ou plusieurs propriétés étendues à valeurs multiples dans un calendrier nouveau ou existant.
Obtenir une propriété à valeurs multiples calendrier Obtenez un calendrier qui contient une propriété étendue à valeurs multiples à l’aide de $expand.

Propriétés

Propriété Type Description
allowedOnlineMeetingProviders collection onlineMeetingProviderType Représente les fournisseurs de service de réunion en ligne qui peuvent être utilisés pour créer des réunions en ligne dans ce calendrier. Les valeurs possibles sont les suivantes : unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
canEdit Boolean true si l’utilisateur peut écrire dans le calendrier, false dans le cas contraire. Cette propriété est true pour l’utilisateur qui a créé le calendrier. Cette propriété est également true pour un utilisateur avec qui un calendrier a été partagé et à qui l’accès en écriture a été octroyé.
canShare Boolean true si l’utilisateur dispose de l’autorisation de partager le calendrier, false dans le cas contraire. Seul l’utilisateur qui a créé le calendrier peut le partager.
canViewPrivateItems Boolean true si l’utilisateur peut lire les éléments de calendrier marqués comme privés, false dans le cas contraire.
changeKey String Identifie la version de l’objet de calendrier. Chaque fois que le calendrier est modifié, changeKey change également. Exchange peut ainsi appliquer les modifications à la version correcte de l’objet. En lecture seule.
color calendarColor Spécifie le thème de couleur pour distinguer le calendrier d’autres calendriers dans une interface utilisateur. Les valeurs des propriétés sont : auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor.
defaultOnlineMeetingProvider onlineMeetingProviderType Fournisseur de réunion en ligne par défaut pour les réunions envoyées à partir de ce calendrier. Les valeurs possibles sont les suivantes : unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
hexColor String Couleur du calendrier, exprimée dans un code de couleur hexadécimal de trois valeurs hexadécimales, chacune entre 00 et FF et représentant les composants rouge, vert ou bleu de la couleur dans l’espace de couleurs RVB. Si l’utilisateur n’a jamais défini explicitement de couleur pour le calendrier, cette propriété est vide. En lecture seule.
id String Identificateur unique du calendrier. En lecture seule.
isDefaultCalendar Boolean true s’il s’agit du calendrier par défaut dans lequel les nouveaux événements sont créés par défaut, sinon false.
isRemovable Boolean Indique si ce calendrier utilisateur peut être supprimé de la boîte aux lettres utilisateur.
isTallyingResponses Boolean Indique si ce calendrier utilisateur prend en charge le suivi des réponses aux réunions. Seules les invitations aux réunions envoyées depuis le calendrier principal des utilisateurs prennent en charge le suivi des réponses aux réunions.
nom Chaîne Nom du calendrier.
owner emailAddress Si elle est définie, cette valeur représente l’utilisateur qui a créé ou ajouté le calendrier. Pour un calendrier créé ou ajouté par l’utilisateur, la propriété owner est définie sur l’utilisateur. Pour un calendrier partagé avec l’utilisateur, la propriété owner est définie sur la personne qui a partagé ce calendrier avec l’utilisateur.

Relations

Relation Type Description
calendarPermissions Collection calendarPermission Autorisations des utilisateurs avec qui le calendrier est partagé.
calendarView collection Event Affichage Calendrier pour le calendrier. Propriété de navigation. En lecture seule.
events collection Event Événements dans le calendrier. Propriété de navigation. En lecture seule.
multiValueExtendedProperties collection multiValueLegacyExtendedProperty Collection des propriétés étendues à plusieurs valeurs définies pour le calendrier. En lecture seule. Pouvant accepter la valeur Null.
singleValueExtendedProperties collection singleValueLegacyExtendedProperty Collection des propriétés étendues à valeurs uniques définies pour le calendrier. En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "allowedOnlineMeetingProviders": ["string"],
  "canEdit": "boolean",
  "canShare": "boolean",
  "canViewPrivateItems": "boolean",
  "changeKey": "string",
  "color": "String",
  "defaultOnlineMeetingProvider": "string",
  "hexColor": "String",
  "id": "string (identifier)",
  "isDefaultCalendar": "boolean",
  "isRemovable": "boolean",
  "isTallyingResponses": "boolean",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}