Información general sobre la API de calendario de Outlook

El calendario de Outlook forma parte del centro de mensajería de Outlook en Microsoft 365 que también le permite administrar correos electrónicos y contactos, buscar información sobre los usuarios de la organización, iniciar conversaciones en línea, compartir archivos y colaborar en grupos.

¿Por qué debería realizar la integración con el calendario de Outlook?

Las ricas características del calendario de Outlook y su API ofrecen muchas oportunidades de aplicaciones. En las secciones siguientes se muestran algunas de ellas.

Llegar a cientos de millones de clientes y crear escenarios enriquecidos

Muchos millones de clientes usan el calendario de Outlook como parte de un concentrador integrado que permite comunicarse de forma eficaz y aumentar la productividad. Pueden programar reuniones, administrar los mensajes de correo electrónico, buscar información sobre los contactos y otros usuarios, e iniciar conversaciones o reuniones en línea en un solo lugar, ya sea en la web, en el móvil o en el escritorio. Microsoft Graph no solo conecta las aplicaciones con el calendario, el correo y los datos de contactos de estos clientes, también permite a las aplicaciones integrarse con lo mejor de Microsoft 365 y ser compatibles con una amplia variedad de escenarios que mejoran la productividad y la colaboración.

La mayoría de las características de la API de calendario de Outlook se aplican a calendarios de cuentas personales de Microsoft y cuentas profesionales o educativas.

** Indica características que se aplican específicamente a los calendarios de Outlook solo de cuentas profesionales o educativas.

Automatizar la organización de citas y los calendarios

A los clientes les gusta cómo Outlook les permite organizar su tiempo de trabajo, familiar y de actividades personales. La API de REST de Microsoft Graph mantiene la igualdad con la experiencias del cliente y permite a las aplicaciones crear, administrar y responder a eventos con esa misma naturalidad:

  • En Outlook, los clientes pueden crear calendarios individuales para el trabajo, la familia y otros fines y organizarlos en grupos de calendarios. Pueden activar los calendarios gratuitos Cumpleaños y Días festivos para que les recuerden los cumpleaños de los contactos y los días festivos locales. Pueden agregar calendarios que se adapten a sus intereses, como los calendarios de equipos deportivos y programas de televisión. Los clientes pueden seleccionar y superponer calendarios, para así poder ver sus eventos en la misma vista. A través de la API de calendario, la aplicación puede organizar calendarios de forma similar en grupos de calendarios e interactuar con calendarios interesantes como cualquier otro calendario en el buzón del usuario.

  • Los clientes de Outlook pueden aplicar categorías a eventos, mensajes, contactos, tareas y entradas de grupo de forma coherente para mejorar la organización y detección. La API de calendario le permite acceder a la lista principal de un usuario de categorías y definirla, lo que abre las puertas a escenarios creativos adicionales. Por ejemplo, un club deportivo puede organizar un torneo y ofrecer una aplicación que diferencia correos electrónicos y eventos de cada deporte con su propia categoría de color. Para las últimas noticias como cambios imprevistos de calendario, la aplicación también puede establecer la propiedad importance de los eventos y mensajes de correo electrónico para avisar a los clientes.

  • En una carpeta de calendario, puede crear y actualizareventos de instancia única, o programar y mantener eventos periódicos. Puede permitir que los clientes respondan a las convocatorias de reunión y posponer o descartaravisos mediante la propiedad de navegación de eventos asociada.

Ayudar a los clientes a mantenerse sincronizados y organizar sus días

La API de calendario permite que los clientes organicen sus días y mejoren la productividad:

Mejorar la colaboración

  • En Outlook, los clientes pueden compartir los calendarios con otros y conceder permisos para leer, escribir o eliminar contenido de los calendarios. También pueden delegar un calendario para permitir que otro cliente responda a convocatorias de reunión en su nombre. Mediante programación, aunque no puede iniciar una acción de compartir o delegar en nombre de un usuario, puede usar un conjunto de propiedades para comprobar el estado de uso compartido y habilitar escenarios para calendarios compartidos o delegados: canEdit, canShare, canViewPrivateItems, isShared y isSharedWithMe.
  • La API del calendario le permite obtener elementos del calendario del usuario que ha iniciado sesión o de los usuarios que han compartido o delegado sus calendarios con el usuario que ha iniciado sesión. Por ejemplo, si Jorge ha compartido un calendario con Juan o si le ha delegado el acceso, en ese caso los permisos delegados de Juan le proporcionaría acceso de lectura al calendario compartido de Jorge, así como a su contenido.
  • Los grupos de Microsoft 365 facilitan a los miembros del grupo colaborar y acceder a las conversaciones del grupo y calendarios directamente en Outlook. Excepto unas pocas diferencias entre los calendarios de grupo y los calendarios de usuario, la API de calendario le permite interactuar con los calendarios de grupo como si fuesen calendarios de usuario. Vea el recurso calendar para obtener más información**.

Programar de forma inteligente

Outlook y la API de calendario ofrecen varias ventajas inteligentes para programar eventos:

  • A través de la configuración de la aplicación de calendario de Outlook, los clientes pueden habilitar que se agreguen eventos desde los correos electrónicos de forma automática, como reservas de vuelos, hoteles o restaurante, y facturas. Una vez que se han agregado, puede interactuar con estos eventos como si fuesen cualquier otro objeto event en el buzón del usuario y crear escenarios creativos en esta funcionalidad de Outlook.
  • En Outlook, reservar una sala de reuniones es tan fácil como agregar un asistente al event. La API de calendario representa una sala de reuniones como un objeto emailAddress. También puede obtener salas y obtener listas de las salas disponibles en un espacio empresarial. Para organizar una reunión en una sala específica, puede asignarla a la propiedad location del event.**
  • Puede buscar la información de disponibilidad de los usuarios y recursos durante un periodo de tiempo determinado. Luego, puede usar estos datos para aplicarlos a los distintos escenarios, incluidos la programación de eventos y la planeación de recursos.**
  • Si su escenario implica programar reuniones en un momento óptimo, puede considerar usar findMeetingTimes para identificar posibles horas o ubicaciones para reunirse. La función findMeetingTimes considera el estado de disponibilidad de los asistentes, las salas y horas preferidas y otras restricciones que indique. Si el primer intento no devuelve una hora de reunión común, compruebe la razón, ajuste los criterios y llame a findMeetingTimes de nuevo.**

Teleconferencia en varias ubicaciones y zonas horarias

Con la globalización, las reuniones de negocios de hoy en día suelen implicar a asistentes que participan desde diferentes ubicaciones y zonas horarias. Le mostramos cómo puede usar la API de calendario para administrar estas reuniones:

  • Por ejemplo en Outlook, los clientes pueden organizar una reunión e incluir a asistentes que se unen desde una sala de conferencias en Seattle, una cafetería en París o una oficina doméstica en China. Mediante programación, la propiedad locations del evento, que es una colección de objetos location, puede reflejar este nivel de detalles en displayName y locationType para cada location. Consulte un ejemplo.
  • Outlook proporciona a los clientes la flexibilidad para organizar eventos y especificar una zona horaria para cada una de las horas de inicio y finalización de un evento. Para admitir esta flexibilidad, de forma predeterminada, la API de calendario devuelve las horas de inicio y finalización de un evento en UTC y proporciona las propiedades originalStartTimeZone y originalEndTimeZone para indicar las zonas horarias utilizadas cuando se creó el evento.
  • Como alternativa, puede especificar el encabezado Prefer: outlook.timezone="{time zone name}" para que una operación de evento GET devuelva la hora de inicio y finalización en la zona horaria que especifique. El nombre de la zona horaria puede ser uno de los compatibles con Windows, así como los de esta lista. Vea un ejemplo del encabezado Prefer en uso.
  • Las organizaciones que admiten proveedores de reuniones en línea, como Microsoft Teams y Skype, pueden configurar los calendarios de Outlook para usar dichos proveedores. Puede organizar o asistir a eventos en estos calendarios como también a reuniones en línea de manera conveniente.

Crear aplicaciones con reconocimiento de ubicación y proporcionar contexto inteligente

Use la API de sitios para ayudar a los usuarios a desplazarse a un lugar o proporcionar una solución inteligente basada en la ubicación del usuario. A continuación, se indican algunos escenarios de ejemplo:

  • Incorporar detalles del sitio en los eventos del calendario para ayudar a los usuarios a navegar su día y mejorar la productividad.**
  • Las aplicaciones de catering pueden usar la API de sitios para ayudar en la navegación y la configuración del lugar.**
  • Automatizar el envío de correos electrónicos con los detalles antes de la reunión a los asistentes e incluir un mapa para mostrar cómo llegar a una sala.**
  • Configurar los asistentes de bots de recepción para proporcionar información sobre salas específicas de un edificio.**

Según el escenario de la aplicación, puede usar la API de sitios en el contexto de Outlook o de forma independiente de Outlook.

Aprovechar la inteligencia social y otras ventajas de desarrollador de Microsoft Graph

Use la API de contactos en Microsoft Graph para conectarse a los datos de contactos que se basan en los patrones de comunicación y colaboración de un usuario y en las relaciones comerciales de un usuario. Puede implementar controles como un selector de personas y sugerir a personas relevantes para el usuario al organizar reuniones en nombre del usuario.

Evite sobrecargas de almacenamiento y administración de datos en almacenes de datos de la aplicación externos. Con Microsoft Graph, puede almacenar los datos de la aplicación personalizada como extensiones abiertas en casos de recursos individuales. Si necesita que los datos tengan un tipo, o desea poder compartir el esquema con tipo, puede almacenar los datos de la aplicación personalizada en extensiones de esquema.

¿Dónde están los datos?

La API de Microsoft Graph es compatible con el acceso a los datos del buzón principal y los buzones compartidos de los usuarios. Los datos pueden ser contactos personales, de correo electrónico o de calendario almacenados en un buzón en la nube de Exchange Online como parte de Microsoft 365 o en Exchange local en una implementación híbrida.

La API no permite el acceso a buzones de archivo locales, ni en Exchange Online ni en Exchange Server.

Referencia de la API

¿Busca la referencia de la API para este servicio?