Información general sobre la API de calendario de OutlookOutlook calendar API overview

El calendario de Outlook forma parte del centro de mensajería de Outlook en Office 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.Outlook calendar is part of the Outlook messaging hub in Office 365 that also lets you manage emails and contacts, find information about users in an organization, initiate online conversations, share files, and collaborate in groups.

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

Llegar a cientos de millones de clientes y crear escenarios enriquecidosReach hundreds of millions of customers and build rich scenarios

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.Many millions of customers use Outlook calendar as part of an integrated hub that lets them effectively communicate and get things done. 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.They can set up meetings, manage emails, find information about contacts and other users, and initiate conversations or online meetings all in one place, be it on the web, mobile, or desktop. 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.Microsoft Graph not only connects apps to the calendar, mail, and contacts data of these customers, it enables apps to integrate with the best of Microsoft 365 and support a wide range of scenarios that enhance productivity and collaboration.

Automatizar la organización de citas y los calendariosAutomate appointment organization and calendaring

A los clientes les gusta cómo Outlook les permite organizar su tiempo de trabajo, familiar y de actividades personales.Customers like how Outlook lets them organize their time for work, family, and personal activities. 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:Microsoft Graph REST API keeps close parity with the customer experience, letting apps create, manage, and respond to events just as naturally:

  • En Outlook, los clientes pueden crear calendarios individuales para el trabajo, la familia y otros fines y organizarlos en grupos de calendarios.In Outlook, customers can create individual calendars for work, family, and other purposes, and organize them in calendar groups. 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.They can turn on the free Birthdays and Holiday calendar to remind them of contacts' birthdays and local holidays. Pueden agregar calendarios que se adapten a sus intereses, como los calendarios de equipos deportivos y programas de televisión.They can add calendars that match their interests, such as calendars for sport teams and TV programs. Los clientes pueden seleccionar y superponer calendarios, para así poder ver sus eventos en la misma vista.Customers can select and overlay calendars, and see their events in the same view. A través de la API de calendario, la aplicación puede organizar de forma similar calendarios en grupos de calendarios e interactuar con los calendarios interesantes como con cualquier otro calendario en el buzón del usuario.Through the calendar API, your app can similarly organize calendars in calendar groups, and interact with interesting calendars just like any other calendar in the user's mailbox.

  • 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.Outlook customers can apply categories to events, messages, contacts, tasks, and group posts in a consistent way to enhance organization and disovery. 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.The calendar API lets you access and define a user's master list of categories, which opens up additional creative scenarios. 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.For example, an athletic club can organize a sports tournament and offer an app that differentiates emails and events for each sport with their own color category. 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.For last-minute news such as unforeseen timetable changes, the app can also set the importance property of those events and emails to alert customers.

  • En una carpeta de calendario, puede crear y actualizar eventos de instancia única, o programar y mantener eventos periódicos.In a calendar folder, you can create and update single instance events, or schedule and maintain recurring events. Puede permitir que los clientes respondan a convocatorias de reunión y pospongan o descarten avisos con la propiedad de navegación event asociada.You can let your customers respond to meeting requests, and snooze or dismiss reminders using the associated event navigation property.

Ayudar a los clientes a mantenerse sincronizados y organizar sus díasHelp customers stay synchronized and navigate their day

La API de calendario permite que los clientes organicen sus días y mejoren la productividad:The calendar API helps customers navigate their day and enhance productivity:

Mejorar la colaboraciónEnhance collaboration

  • En Outlook, los clientes pueden compartir los calendarios con otros y conceder permisos para leer, escribir o eliminar contenido de los calendarios.In Outlook, customers can share calendars with one another and give permissions to read, write, or delete calendar contents. También pueden delegar un calendario para permitir que otro cliente responda a convocatorias de reunión en su nombre.Or, they can delegate a calendar to let another customer respond to meeting requests on their behalf. 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.Programmatically, while you cannot initiate a share or delegate action on behalf of a user, you can use a set of properties to verify the sharing status and enable scenarios around shared or delegated calendars: canEdit, canShare, canViewPrivateItems, isShared, and 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.The calendar API lets you get calendar items of the signed-in user, or users who have shared or delegated their calendars to the signed-in user. 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.For example, if Garth has shared a calendar with John, or if Garth has delegated access to John, then delegated permissions from John would give you read access to Garth's shared calendar and contents as well.
  • ** Los grupos de Office 365 facilitan a los miembros del grupo colaborar y acceder a las conversaciones del grupo y calendarios directamente en Outlook.** Office 365 groups make it convenient for group members to collaborate and access group conversations and calendars right in 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.Aside from a few minor differences between group calendars and user calendars, the calendar API lets you interact with group calendars just like user calendars. Consulte el recurso calendar para obtener más información.See the calendar resource for more information.

** Indica características que se aplican específicamente a los calendarios de Outlook de cuentas profesionales o educativas.** Denotes features specifically applicable to Outlook calendars in work or school accounts.

Programar de forma inteligenteSchedule smart

Outlook y la API de calendario ofrecen varias ventajas inteligentes para programar eventos:Outlook and the calendar API offer many smart conveniences to schedule events:

  • 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.Through Outlook calendar app settings, customers can enable automatic adding of events from emails, such as flight, hotel, or dining reservations, and billing invoices. 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.Once added, you can interact with these events just like any other event objects in the user's mailbox, and build creative scenarios upon this Outlook capability.
  • ** En Outlook, reservar una sala de reuniones es tan fácil como agregar un asistente al evento.** In Outlook, booking a meeting room is as straight-forward as adding an attendee to the event. La API de calendario representa una sala de reuniones como un objeto emailAddress.The calendar API represents a meeting room as an emailAddress object. También puede obtener salas (versión preliminar) y obtener listas de las salas (versión preliminar) disponibles en un espacio empresarial.You can get rooms (preview) and get room lists (preview) that are available in a tenant. Para organizar una reunión en una sala específica, puede asignarla a la propiedad location del evento.To organize a meeting in a specific room, assign it to the location property of the event.
  • ** Puede buscar la información de disponibilidad de los usuarios y recursos durante un periodo de tiempo determinado.** You can look up the free/busy information for users and resources for a specific time period. A continuación, puede usar estos datos para aplicar a los distintos escenarios, incluidos la programación de eventos y la planeación de recursos.You can then use this data to apply to different scenarios including resource planning and event scheduling.
  • ** Si su caso implica programar reuniones en un momento óptimo, puede considerar el uso de findMeetingTimes para identificar posibles horas o ubicaciones para reunirse.** If your scenario involves scheduling meetings at an optimal time, you can consider using findMeetingTimes to identify possible times or locations to meet. La función findMeetingTimes considera el estado de disponibilidad de los asistentes y las salas y horas preferidas y otras restricciones que indique.The findMeetingTimes function considers the free/busy status of the attendees, and any preferred rooms, time, and other constraints you provide. 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.If the first try doesn't return a common meeting time, check the reason, adjust your criteria and call findMeetingTimes again.

Teleconferencia en varias ubicaciones y zonas horariasTeleconference across multiple locations and time zones

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.With globalization, today's business meetings often involve attendees participating from different locations and time zones. Le mostramos cómo puede usar la API de calendario para administrar estas reuniones:Here's how you can use the calendar API to manage such meetings:

  • 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.As an example in Outlook, customers can organize a meeting and include attendees joining from a conference room in Seattle, a coffee shop in Paris, and a home office in 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.Programmatically, the event locations property, which is a collection of location objects, can reflect this level of details in displayName and locationType for each location. Consulte un ejemplo.See an example.
  • 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.Outlook gives customers the flexibility to organize events and specify a time zone for each of the start and end times of an event. 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.To support this flexibility, by default, the calendar API returns the start and end times of an event in UTC, and provides the originalStartTimeZone and originalEndTimeZone properties to note the time zones used when the event was created.
  • 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.Alternatively, you can specify the Prefer: outlook.timezone="{time zone name}" header so that a GET event operation returns start and end in the time zone you specify. El nombre de la zona horaria puede ser uno de los compatibles con Windows, así como los de esta lista.The time zone name can be any of those supported by Windows, as well as those on this list. Vea un ejemplo del encabezado Prefer en uso.See an example of the Prefer header in use.

Aprovechar la inteligencia social y otras ventajas de desarrollador de Microsoft GraphTake advantage of social intelligence and other developer conveniences in Microsoft Graph

Use la API de contactos en Microsoft Graph para conectarse a datos de contactos que se basan en los patrones de comunicación y colaboración de un usuario y en las relaciones empresariales.Use the people API in Microsoft Graph to connect to people data which is based on a user's communication and collaboration patterns, and business relationships. Puede implementar controles como un selector de personas y sugerir a personas relevantes para el usuario al organizar reuniones en nombre del usuario.You can implement controls such as a people picker, and suggest persons relevant to the user when organizing meetings on the user's behalf.

Evite sobrecargas de almacenamiento y administración de datos en almacenes de datos de la aplicación externos.Save overhead in storing and managing app data in external data stores. Con Microsoft Graph, puede almacenar los datos de la aplicación personalizada como extensiones abiertas en casos de recursos individuales.With Microsoft Graph, you can store custom app data as open extensions in individual resource instances. 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.If you require the data to be typed, or would like to be able to share the typed schema, you can store custom app data in schema extensions.

Referencia de la APIAPI reference

¿Busca la referencia de la API para este servicio?Looking for the API reference for this service?

Pasos siguientesNext steps