Type de ressource « event »event resource type

Ce peut être le calendrier d’un utilisateur ou le calendrier par défaut d’un groupeOffice 365.An event in a user calendar, or the default calendar of an Office 365 group.

Cette ressource prend en charge les fonctions suivantes :This resource supports:

Remarque : il existe quelques différences mineures dans la façon dont vous pouvez interagir avec les calendriers des utilisateurs, groupes de calendriers et leurs événements :Note: There are a few minor differences in the way you can interact with user calendars, group calendars, and their events:

  • Vous pouvez organiser uniquement les calendriers d’utilisateur dans un calendarGroup.You can organize only user calendars in a calendarGroup.
  • Outlook accepte automatiquement toutes les demandes de réunion au nom de groupes.Outlook automatically accepts all meeting requests on behalf of groups. Vous pouvez accepter, accepter provisoirement, ou refuser demandes de réunion pour uniquement les calendriers_utilisateur_.You can accept, tentatively accept, or decline meeting requests for user calendars only.
  • Outlook ne prend en charge les rappels pour les événements de groupe.Outlook doesn't support reminders for group events. Vous pouvez répéter ou faire disparaître un rappel pour les calendriers_utilisateur_uniquement.You can snooze or dismiss a reminder for user calendars only.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
Répertorier les événementsList events collection eventevent collection Récupère la liste des objets event présents dans la boîte aux lettres de l’utilisateur. La liste contient les instances uniques de réunions et les masques des séries.Retrieve a list of event objects in the user's mailbox. The list contains single instance meetings and series masters.
Créer un événementCreate event eventevent Crée un événement en publiant dans la collection d’instances.Create a new event by posting to the instances collection.
Obtenir un événementGet event eventevent Lis les propriétés et les relations de l’objet « event ».Read properties and relationships of event object.
Mettre à jourUpdate eventevent Met à jour l’objet « event ».Update event object.
SupprimerDelete AucunNone Supprime l’objet « event ».Delete event object.
Accepteraccept AucunNone Accepter l’événement spécifié dans un calendrier de l’utilisateur.Accept the specified event in a user calendar.
tentativelyAccepttentativelyAccept AucunNone Essayer d’accepter l’événement spécifié dans un calendrier utilisateur.Tentatively accept the specified event in a user calendar.
Refuserdecline AucunNone Refuser une invitation à l’événement spécifié.Decline invitation to the specified event in a user calendar.
deltadelta collection eventevent collection Obtenez un ensemble d’événements qui ont été ajoutés, supprimés ou mis à jour dans un calendarView (plage d’événements) du calendrier principal de l’utilisateur.Get a set of events that have been added, deleted, or updated in a calendarView (a range of events) of the user's primary calendar.
dismissReminderdismissReminder AucunNone Ignore le rappel pour l’événement spécifié.Dismiss the reminder for the specified event in a user calendar.
snoozeRemindersnoozeReminder AucunNone Reporte le rappel pour l’événement spécifié dans le calendrier utilisateur jusqu’à nouvel ordre.Postpone a reminder for the specified event in a user calendar until a new time.
Répertorier la liste des instancesList instances collection eventevent collection Obtient les instances (occurrences) d’un événement pour un intervalle de temps spécifié. Si l’événement est de type SeriesMaster, il renvoie les occurrences et les exceptions de l’événement sur la plage de temps spécifiée.Get the instances (occurrences) of an event for a specified time range. If the event is a SeriesMaster type, this returns the occurrences and exceptions of the event in the specified time range.
AttachmentsAttachments
Répertorier les pièces jointesList attachments collection attachmentattachment collection Obtient toutes les pièces jointes d’un événement.Get all attachments on an event.
Add attachmentAdd attachment attachmentattachment Ajoute une nouvelle pièce jointe à un événement en publiant dans la collection d’objets « attachment » .Add a new attachment to an event by posting to the attachments collection.
Extensions d’ouvertureOpen extensions
Créer une extension d’ouvertureCreate open extension openTypeExtensionopenTypeExtension Crée une extension d’ouverture et ajoute des propriétés personnalisées dans une instance nouvelle ou existante d’une ressource.Create an open extension and add custom properties in a new or existing instance of a resource.
Obtenir une extension d’ouvertureGet open extension collection openTypeExtensionopenTypeExtension collection Obtient un objet d’extension d’ouverture ou des objets identifiés par leur nom ou leur nom complet.Get an open extension object or objects identified by name or fully qualified name.
Propriétés étenduesExtended properties
Créer une propriété étendue à valeur uniqueCreate single-value extended property eventevent Crée une ou plusieurs propriétés étendues à valeur unique dans un événement nouveau ou existant.Create one or more single-value extended properties in a new or existing event.
Obtenir un événement avec une propriété étendue à valeur uniqueGet event with single-value extended property eventevent Obtient des événements contenant une propriété étendue à valeur unique à l’aide de $expand ou $filter.Get events that contain a single-value extended property by using $expand or $filter.
Créer une propriété étendue à valeurs multiplesCreate multi-value extended property eventevent Crée une ou plusieurs propriétés étendues à valeurs multiples dans un événement nouveau ou existant.Create one or more multi-value extended properties in a new or existing event.
Obtenir un événement avec des propriétés étendues à valeurs multiplesGet event with multi-value extended property eventevent Obtient un événement contenant une propriété étendue à valeurs multiples à l’aide de $expand.Get an event that contains a multi-value extended property by using $expand.

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
attendeesattendees collection attendeeattendee collection Collection des participants à l’événement.The collection of attendees for the event.
corpsbody itemBodyitemBody Corps du message associé à l’événement. Peut être au format HTML ou texte.The body of the message associated with the event. It can be in HTML or text format.
bodyPreviewbodyPreview StringString Aperçu du message associé à l’événement. Valeur au format texte.The preview of the message associated with the event. It is in text format.
categoriescategories String collectionString collection Catégories associées à l’événement.The categories associated with the event.
changeKeychangeKey ChaîneString Identifie la version de l’objet « event ». Chaque fois que l’événement est modifié, la propriété ChangeKey change également. Exchange peut ainsi appliquer les modifications à la version correcte de l’objet.Identifies the version of the event object. Every time the event is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, minuit UTC le 1er janvier 2014 se présente comme suit : '2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
endend dateTimeTimeZonedateTimeTimeZone Date, heure et fuseau horaire de fin de l’événement.The date, time, and time zone that the event ends. Par défaut, l’heure de fin est au format UTC.By default, the end time is in UTC.
hasAttachmentshasAttachments BooleanBoolean Valeur True si l’événement a des pièces jointes.Set to true if the event has attachments.
iCalUIdiCalUId StringString Identificateur unique partagé par toutes les instances d’un événement dans différents calendriers.A unique identifier that is shared by all instances of an event across different calendars. En lecture seule.Read-only.
idid StringString En lecture seule.Read-only.
importanceimportance importanceimportance Importance de l’événement.The importance of the event. Les valeurs possibles sont low, normal, high.The possible values are: low, normal, high.
isAllDayisAllDay BooleanBoolean Valeur True si l’événement dure toute la journée.Set to true if the event lasts all day.
isCancelledisCancelled BooleanBoolean Valeur True si l’événement a été annulé.Set to true if the event has been canceled.
isOrganizerisOrganizer BooleanBoolean Valeur True si l’expéditeur du message est également l’organisateur.Set to true if the message sender is also the organizer.
isReminderOnisReminderOn BooleanBoolean Valeur True si une alerte est définie pour rappeler l’événement à l’utilisateur.Set to true if an alert is set to remind the user of the event.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, minuit UTC le 1er janvier 2014 se présente comme suit : '2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
locationlocation locationlocation Emplacement de l’événement.The location of the event.
locationslocations Collection locationlocation collection Emplacements où l’événement est tenu.The locations where the event is held or attended from. Les propriétés location et locations se correspondent toujours mutuellement.The location and locations properties always correspond with each other. Si vous mettez à jour la propriété location, tous les emplacements précédents dans la collection locations sont supprimés et remplacés par la nouvelle valeur location.If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.
onlineMeetingUrlonlineMeetingUrl StringString Une URL pour une réunion en ligne.A URL for an online meeting. La propriété est définie uniquement lorsqu’un organisateur spécifie un événement comme une réunion en ligne tel qu’une réunion Skype.The property is set only when an organizer specifies an event as an online meeting such as a Skype meeting. En lecture seule.Read-only.
organizerorganizer recipientrecipient Organisateur de l’événement.The organizer of the event.
originalEndTimeZoneoriginalEndTimeZone StringString Fuseau horaire de fin défini lors de la création de l’événement.The end time zone that was set when the event was created. La valeur tzone://Microsoft/Custom indique qu’un fuseau horaire personnalisé hérité a été défini dans Outlook bureau.A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
originalStartoriginalStart DateTimeOffsetDateTimeOffset Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, minuit UTC le 1er janvier 2014 se présente comme suit : '2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
originalStartTimeZoneoriginalStartTimeZone ChaîneString Fuseau horaire de début défini lors de la création de l’événement. La valeur tzone://Microsoft/Custom indique qu’un fuseau horaire personnalisé hérité a été défini dans Outlook bureau.The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
recurrencerecurrence patternedRecurrencepatternedRecurrence Modèle de périodicité pour l’événement.The recurrence pattern for the event.
reminderMinutesBeforeStartreminderMinutesBeforeStart Int32Int32 Nombre de minutes avant la date de début de l’événement où l’alerte de rappel a lieu.The number of minutes before the event start time that the reminder alert occurs.
responseRequestedresponseRequested BooleanBoolean Valeur True si l’expéditeur souhaite une réponse lorsque l’événement est accepté ou refusé.Set to true if the sender would like a response when the event is accepted or declined.
responseStatusresponseStatus responseStatusresponseStatus Indique le type de réponse envoyé en réponse à un message d’événement.Indicates the type of response sent in response to an event message.
sensitivitysensitivity sensitivitysensitivity Les valeurs possibles sont normal, personal, private, confidential.The possible values are: normal, personal, private, confidential.
seriesMasterIdseriesMasterId ChaîneString L’ID de la série maîtrise un élément périodique, si cet événement fait partie d’une série périodique.The ID for the recurring series master item, if this event is part of a recurring series.
showAsshowAs freeBusyStatusfreeBusyStatus État à afficher.The status to show. Les valeurs possibles sont free, tentative, busy, oof, workingElsewhere, unknown.The possible values are: free, tentative, busy, oof, workingElsewhere, unknown.
startstart dateTimeTimeZonedateTimeTimeZone Date, heure et fuseau horaire de début de l’événement.The date, time, and time zone that the event starts. Par défaut, l’heure de début est au format UTC.By default, the start time is in UTC.
sujetsubject StringString Texte de la ligne d’objet de l’événement.The text of the event's subject line.
typetype eventTypeeventType Type d’événement.The event type. Les valeurs possibles sont singleInstance, occurrence, exception, seriesMaster.The possible values are: singleInstance, occurrence, exception, seriesMaster. En lecture seule.Read-only.
webLinkwebLink StringString URL permettant d’ouvrir l’événement dans Outlook Web App.The URL to open the event in Outlook Web App.

L’événement s’ouvre dans le navigateur si vous êtes connecté à votre boîte aux lettres via Outlook Web App. Si vous n’êtes pas déjà connecté avec le navigateur, vous êtes invité à le faire.The event will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

Cette URL est accessible à partir d’un iFrame.This URL can be accessed from within an iFrame.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
pièces jointesattachments collection attachmentattachment collection Collection des pièces jointes fileAttachment et itemAttachment pour l’événement. Propriété de navigation. En lecture seule. Peut avoir la valeur Null.The collection of fileAttachment and itemAttachment attachments for the event. Navigation property. Read-only. Nullable.
calendriercalendar calendarcalendar Calendrier contenant l’événement. Propriété de navigation. En lecture seule.The calendar that contains the event. Navigation property. Read-only.
extensionsextensions collection ExtensionExtension collection Collection des extensions d’ouverture définies pour l’événement.The collection of open extensions defined for the event. En lecture seule.Read-only. Peut avoir la valeur Null.Nullable.
instancesinstances collection eventevent collection Instances de l’événement. Propriété de navigation. En lecture seule. Peut avoir la valeur Null.The instances of the event. Navigation property. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties collection multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection Collection des propriétés étendues à valeurs multiples définies pour l’événement. En lecture seule. Peut avoir la valeur Null.The collection of multi-value extended properties defined for the event. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties collection singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection Collection des propriétés étendues à valeur unique définies pour l’événement. En lecture seule. Peut avoir la valeur Null.The collection of single-value extended properties defined for the event. Read-only. Nullable.

Représentation JSONJSON representation

Voici une représentation JSON de la ressourceHere is a JSON representation of the resource

{
  "attendees": [{"@odata.type": "microsoft.graph.attendee"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "changeKey": "string",
  "createdDateTime": "String (timestamp)",
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "hasAttachments": true,
  "iCalUId": "string",
  "id": "string (identifier)",
  "importance": "String",
  "isAllDay": true,
  "isCancelled": true,
  "isOrganizer": true,
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.location"},
  "locations": [{"@odata.type": "microsoft.graph.location"}],
  "onlineMeetingUrl": "string",
  "organizer": {"@odata.type": "microsoft.graph.recipient"},
  "originalEndTimeZone": "string",
  "originalStart": "String (timestamp)",
  "originalStartTimeZone": "string",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderMinutesBeforeStart": 1024,
  "responseRequested": true,
  "responseStatus": {"@odata.type": "microsoft.graph.responseStatus"},
  "sensitivity": "String",
  "seriesMasterId": "string",
  "showAs": "String",
  "start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "type": "String",
  "webLink": "string",

  "attachments": [ { "@odata.type": "microsoft.graph.attachment" } ],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "extensions": [ { "@odata.type": "microsoft.graph.extension" } ],
  "instances": [ { "@odata.type": "microsoft.graph.event" }],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }]

}

Voir aussiSee also