type de ressource calendar

Espace de noms: microsoft.graph

Importante

Les API sous la /beta version dans Microsoft Graph sont susceptibles de changer. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version .

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.
Update 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 Aucun Supprimez un objet calendar.
Répertorier calendarView 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 masques des séries.
Créer un événement event Crée un événement dans le calendrier spécifié ou par défaut.
getSchedule 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.
findMeetingTimes 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é étendue à valeur unique calendrier Créez une ou plusieurs propriétés étendues à valeur unique dans un calendrier nouveau ou existant.
Obtenir un calendrier avec une propriété étendue à 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é étendue à valeurs multiples calendrier Créez une ou plusieurs propriétés étendues à valeurs multiples dans un calendrier nouveau ou existant.
Obtenir un calendrier avec une propriété étendue à 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.
calendarGroupId Chaîne calendarGroup dans laquelle créer le calendrier. Si l’utilisateur n’a jamais défini explicitement de groupe pour le calendrier, cette propriété a la valeur Null.
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 à qui on a partagé un calendrier et accordé un accès en écriture, par le biais d'un client Outlook ou de la ressource calendarPermission correspondante. En lecture seule.
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. En lecture seule.
canViewPrivateItems Boolean true si l’utilisateur peut lire les éléments de calendrier marqués comme privés, false dans le cas contraire. Cette propriété est définie par le biais d’un client Outlook ou de la ressource calendarPermission correspondante. En lecture seule.
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.
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.
isShared Boolean true si l’utilisateur a partagé le calendrier avec d’autres utilisateurs, sinon false. Comme seul l’utilisateur ayant créé le calendrier peut le partager, isShared et isSharedWithMe ne peuvent pas être définis sur « true » pour le même utilisateur. Cette propriété est définie lorsqu’un partage est démarré dans un client Outlook et peut être redéfinie si le partage est annulé via le client ou la ressource calendarPermission correspondante. En lecture seule.
isSharedWithMe Boolean true si le calendrier a été partagé avec l’utilisateur, sinon false. Cette propriété est toujours définie sur false pour le propriétaire d’un calendrier. Cette propriété est définie lorsqu’un partage est démarré dans un client Outlook et peut être redéfinie si le partage est annulé via le client ou la ressource calendarPermission correspondante. En lecture seule.
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. En lecture seule.

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.
événements 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

Voici une représentation JSON de la ressource.

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