type de ressource calendar
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. 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 v1.0, utilisez le sélecteur 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 |
|---|---|---|
| List | 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. |
| Create | calendrier | Créez un calendrier dans le groupe de calendriers par défaut ou dans un groupe spécifié pour un utilisateur. |
| Obtenir | 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. |
| Supprimer définitivement | Aucune | Supprimez définitivement le dossier calendrier et supprimez-le de la boîte aux lettres. |
| 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 masques 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. |
| 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
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",
"isShared": "boolean",
"isSharedWithMe": "boolean",
"isTallyingResponses": "boolean",
"name": "string",
"owner": {"@odata.type": "microsoft.graph.emailAddress"}
}