List calendarViewList calendarView

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Obtiene las repeticiones, excepciones e instancias únicas de eventos en una vista de calendario definida por un intervalo de tiempo del calendario predeterminado de un usuario, o alguno de los otros calendarios del usuario.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.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite
AplicaciónApplication Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite

Solicitud HTTPHTTP request

calendar predeterminado de un usuario.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}

calendar de un usuario del calendarGroup predeterminado.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}

calendar de un usuario de un calendarGroup específico.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}

Parámetros de consultaQuery parameters

En la dirección URL de la solicitud, proporcione los siguientes parámetros de consulta necesarios con valores.In the request URL, provide the following required query parameters with values.

ParámetroParameter TipoType DescripciónDescription
startDateTimestartDateTime CadenaString La fecha y hora de inicio del intervalo de tiempo, representada en formato ISO 8601. Por ejemplo, "2019-11-08T19:00:00-08:00".The start date and time of the time range, represented in ISO 8601 format. For example, "2019-11-08T19:00:00-08:00".
endDateTimeendDateTime CadenaString La fecha y hora de finalización del intervalo de tiempo, representada en formato ISO 8601. Por ejemplo, "2019-11-08T20:00:00-08:00".The end date and time of the time range, represented in ISO 8601 format. For example, "2019-11-08T20:00:00-08:00".

Los valores de startDateTime y endDateTime son interpretados con el desplazamiento de zona especificados en el valor y no se ven afectados por el valor delPrefer: outlook.timezone encabezado, si está presente.The values of startDateTime and endDateTime are interpreted using the timezone offset specified in the value and are not impacted by the value of the Prefer: outlook.timezone header if present. Si no se incluye ningún desplazamiento entre zonas en el valor, será interpretado como hora UTC.If no timezone offset is included in the value, it is interpreted as UTC.

Este método también admite los Parámetros de consulta de OData a modo de ayuda para personalizar la respuesta.This method also supports some of the OData Query Parameters to help customize the response.

Nota

Las propiedades createdDateTime y lastModifiedDateTime del evento no son compatibles $select.The createdDateTime and lastModifiedDateTime properties of event do not support $select. Para obtener los valores, simplemente realice una consulta en calendarView sin aplicar $select.To get their values, simply query on calendarView without applying $select.

Encabezados de solicitudRequest headers

NombreName TipoType DescripciónDescription
AuthorizationAuthorization stringstring {token} de portador. Obligatorio.Bearer {token}. Required.
Prefer: outlook.timezonePrefer: outlook.timezone stringstring Se usa para especificar la zona horaria de las horas de inicio y final de la respuesta.Use this to specify the time zone for start and end times in the response. Si no se especifican, estos valores de hora se devuelven en UTC.If not specified, those time values are returned in UTC. Opcional.Optional.
Prefer: outlook.body-content-typePrefer: outlook.body-content-type stringstring Formato de la propiedad body que se devolverá.The format of the body property to be returned in. Los valores pueden ser "text" o "html".Values can be "text" or "html". Se devuelve un encabezado Preference-Applied como confirmación si se especifica este encabezado Prefer.A Preference-Applied header is returned as confirmation if this Prefer header is specified. Si no se especifica el encabezado, la propiedad body se devuelve en formato HTML.If the header is not specified, the body property is returned in HTML format. Opcional.Optional.

Cuerpo de la solicitudRequest body

No proporcione un cuerpo de solicitud para este método.Do not supply a request body for this method.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y la colección de objetos event en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and collection of event objects in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

GET https://graph.microsoft.com/v1.0/me/calendarView?startDateTime=2020-01-01T19:00:00-08:00&endDateTime=2020-01-02T19:00:00-08:00
RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.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
    }
  ]
}