evento: Forwardevent: forward

Importante

Las API de /beta la versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported.

Esta acción permite al organizador o asistente de un evento de reunión reenviar la convocatoria de reunión a un nuevo destinatario.This action allows the organizer or attendee of a meeting event to forward the meeting request to a new recipient.

Si el evento de reunión se reenvía desde el buzón de Office 365 de un asistente a otro destinatario, esta acción también envía un mensaje para notificar al organizador el reenvío y agrega al destinatario a la copia del evento de reunión del organizador.If the meeting event is forwarded from an attendee's Office 365 mailbox to another recipient, this action also sends a message to notify the organizer of the forwarding, and adds the recipient to the organizer's copy of the meeting event. Esta conveniencia no está disponible al reenviar desde una cuenta de Outlook.com.This convenience is not available when forwarding from an Outlook.com account.

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.ReadCalendars.Read
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) Calendars.ReadCalendars.Read
AplicaciónApplication Calendars.ReadCalendars.Read

Solicitud HTTPHTTP request

POST /me/events/{id}/forward
POST /users/{id | userPrincipalName}/events/{id}/forward
POST /groups/{id}/events/{id}/forward

POST /me/calendar/events/{id}/forward
POST /users/{id | userPrincipalName}/calendar/events/{id}/forward
POST /groups/{id}/calendar/events/{id}/forward

POST /me/calendars/{id}/events/{id}/forward
POST /users/{id | userPrincipalName}/calendars/{id}/events/{id}/forward

POST /me/calendargroup/calendars/{id}/events/{id}/forward
POST /users/{id | userPrincipalName}/calendargroup/calendars/{id}/events/{id}/forward

POST /me/calendargroups/{id}/calendars/{id}/events/{id}/forward
POST /users/{id | userPrincipalName}/calendargroups/{id}/calendars/{id}/events/{id}/forward

Encabezados de solicitudRequest headers

NombreName TipoType DescripciónDescription
AuthorizationAuthorization stringstring {token} de portador. Obligatorio.Bearer {token}. Required.
Content-TypeContent-Type stringstring Naturaleza de los datos en el cuerpo de una entidad. Obligatorio.Nature of the data in the body of an entity. Required.

Cuerpo de solicitudRequest body

En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.In the request body, provide a JSON object with the following parameters.

ParámetroParameter TipoType DescripciónDescription
CommentComment StringString Comentario que se va a incluir. Puede ser una cadena vacía.A comment to include. Can be an empty string.
ToRecipientsToRecipients Colección recipientrecipient collection La lista de destinatarios a la que se reenviará el evento.The list of recipients to forward the event to.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve el código de respuesta 202 Accepted. No devuelve nada en el cuerpo de la respuesta.If successful, this method returns 202 Accepted response code. It does not return anything in the response body.

EjemploExample

Aquí tiene un ejemplo de cómo llamar a esta API.Here is an example of how to call this API.

SolicitudRequest

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

POST https://graph.microsoft.com/beta/me/events/{id}/forward
Content-type: application/json
Content-length: 56

{
  "ToRecipients":[
      {
        "emailAddress": {
          "address":"danas@contoso.onmicrosoft.com",
          "name":"Dana Swope"
        }
      }
     ],
  "Comment": "Dana, hope you can make this meeting." 
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta.Here is an example of the response.

HTTP/1.1 202 Accepted