List calendarViewList calendarView

Obtenir 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 par défaut de l’utilisateur ou d’un autre calendrier de l’utilisateur.Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's default calendar, or from some other calendar of the user's.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite
ApplicationApplication Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite

Requête HTTPHTTP request

Calendrier par défaut d’un utilisateur.A user's default calendar.

GET /me/calendar/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}
GET /users/{id | userPrincipalName}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}

Calendrier d’un utilisateur dans le groupe de calendriers par défaut.A user's calendar in the default calendarGroup.

GET /me/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}
GET /users/{id | userPrincipalName}/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}

GET /me/calendarGroup/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}
GET /users/{id | userPrincipalName}/calendarGroup/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}

Calendrier d’un utilisateur dans un groupe de calendriers spécifique.A user's calendar in a specific calendarGroup.

GET /me/calendarGroups/{id}/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}
GET /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}

Paramètres de requêteQuery parameters

Dans l’URL de la requête, indiquez les paramètres obligatoires suivants avec leurs valeurs.In the request URL, provide the following required query parameters with values.

ParamètreParameter TypeType DescriptionDescription
startDateTimestartDateTime StringString La date et l’heure de début de la plage horaire, représentées au format ISO 8601. Par exemple, « 2015-11-08T19:00:00.0000000 ».The start date and time of the time range, represented in ISO 8601 format. For example, "2015-11-08T19:00:00.0000000".
endDateTimeendDateTime StringString La date et l’heure de fin de la plage horaire, représentées au format ISO 8601. Par exemple, « 2015-11-08T20:00:00.0000000 ».The end date and time of the time range, represented in ISO 8601 format. For example, "2015-11-08T20:00:00.0000000".

Cette méthode prend également en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.This method also supports the OData Query Parameters to help customize the response.

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization stringstring Porteur {token}. Obligatoire.Bearer {token}. Required.
Prefer: outlook.timezonePrefer: outlook.timezone stringstring Utilisez cette option pour définir le fuseau horaire pour les heures de début et de fin dans la réponse.Use this to specify the time zone for start and end times in the response. Si aucune valeur n’est définie, les heures sont renvoyées au format UTC.If not specified, those time values are returned in UTC. Facultatif.Optional.
Prefer: outlook.body-content-typePrefer: outlook.body-content-type stringstring Format auquel la propriété body est renvoyée.The format of the body property to be returned in. Les valeurs peuvent être au format « texte » ou « html ».Values can be "text" or "html". Un en-tête Preference-Applied est renvoyé à titre de confirmation si l’en-tête Prefer est spécifié.A Preference-Applied header is returned as confirmation if this Prefer header is specified. Si cet en-tête n’est pas spécifié, la propriété body est renvoyée au format HTML.If the header is not specified, the body property is returned in HTML format. Facultatif.Optional.

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et une collection d’objets Event dans le corps de réponse.If successful, this method returns a 200 OK response code and collection of Event objects in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

GET https://graph.microsoft.com/v1.0/me/calendarView?startDateTime=2016-01-01T19:00:00.0000000&endDateTime=2016-10-01T19:00:00.0000000 
RéponseResponse

Voici un exemple de la réponse. Remarque : L’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 354

{
  "value": [
    {
      "originalStartTimeZone": "originalStartTimeZone-value",
      "originalEndTimeZone": "originalEndTimeZone-value",
      "responseStatus": {
        "response": "",
        "time": "datetime-value"
      },
      "iCalUId": "iCalUId-value",
      "reminderMinutesBeforeStart": 99,
      "isReminderOn": true
    }
  ]
}