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"}
}