Obtener calendarioGet calendar

Obtiene las propiedades y relaciones de un objeto de calendario.Get the properties and relationships of a calendar object. El calendario puede ser de un usuario o el calendario predeterminado de un grupo de Office 365.The calendar can be one for a user, or the default calendar of an Office 365 group.

Hay dos posibles escenarios donde una aplicación puede obtener el calendario de otro usuario:There are two scenarios where an app can get another user's calendar:

  • Si la aplicación tiene permisos de aplicación, o bien,If the app has application permissions, or,
  • Si la aplicación tiene los correspondientes permisos delegados de un usuario y otro usuario ha compartido un calendario con ese usuario, o bien, le ha concedido acceso delegado a ese usuario.If the app has the appropriate delegated permissions from one user, and another user has shared a calendar with that user, or, has given delegated access to that user. Vea detalles y un ejemplo.See details and an example.

PermisosPermissions

Según el tipo de calendario en el que se encuentre el evento y el tipo de permiso (delegado o aplicación) que se solicite, se necesita uno de los siguientes permisos para llamar a esta API:Depending on the type of calendar that the event is in and the permission type (delegated or application) requested, one of the following permissions is required to call this API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.To learn more, including how to choose permissions, see Permissions.

CalendarioCalendar Delegado (cuenta profesional o educativa)Delegated (work or school account) Delegado (cuenta de Microsoft personal)Delegated (personal Microsoft account) AplicaciónApplication
calendario de usuariouser calendar Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite Calendars.Read, Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite
calendario de grupogroup calendar Group.Read.All, Group.ReadWrite.AllGroup.Read.All, Group.ReadWrite.All No admitida.Not supported. No admitida.Not supported.

Solicitud HTTPHTTP request

calendar predeterminado de un usuario o grupo.A user's or group's default calendar.

GET /me/calendar
GET /users/{id | userPrincipalName}/calendar
GET /groups/{id}/calendar

calendar de un usuario del calendarGroup predeterminado.A user's calendar in the default calendarGroup.

GET /me/calendars/{id}
GET /users/{id | userPrincipalName}/calendars/{id}

GET /me/calendarGroup/calendars/{id}
GET /users/{id | userPrincipalName}/calendarGroup/calendars/{id}

calendar de un usuario de un calendarGroup específico.A user's calendar in a specific calendarGroup.

GET /me/calendarGroups/{id}/calendars/{id}
GET /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}

Parámetros de consulta opcionalesOptional query parameters

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

Encabezados de solicitudRequest headers

NombreName TipoType DescripciónDescription
AuthorizationAuthorization stringstring {token} de portador. Obligatorio.Bearer {token}. Required.

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 el objeto calendar en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and calendar object in the response body.

EjemploExample

SolicitudRequest

En el ejemplo siguiente se obtiene el calendario predeterminado del usuario que ha iniciado sesión.The following example gets the signed-in user's default calendar.

GET https://graph.microsoft.com/v1.0/me/calendar
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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#me/calendars/$entity",
    "@odata.id": "https://graph.microsoft.com/v1.0/users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/calendars('AAMkAGI2TGuLAAA=')",
    "id": "AAMkAGI2TGuLAAA=",
    "name": "Calendar",
    "color": "auto",
    "changeKey": "nfZyf7VcrEKLNoU37KWlkQAAA0x0+w==",
    "canShare":true,
    "canViewPrivateItems":true,
    "canEdit":true,
    "owner":{
        "name":"Samantha Booth",
        "address":"samanthab@adatum.onmicrosoft.com"
    }
}