event: tentativelyAcceptevent: tentativelyAccept

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Acepta provisionalmente el evento especificado en un calendariode usuario.Tentatively accept the specified event in a user calendar.

Si el evento permite nuevas propuestas de tiempo, en respuesta tentativa al evento, un invitado puede elegir sugerir una hora alternativa incluyendo el parámetro proposedNewTime .If the event allows proposals for new times, on responding tentative to the event, an invitee can choose to suggest an alternative time by including the proposedNewTime parameter. Para obtener más información sobre cómo proponer una hora, y cómo recibir y aceptar una nueva propuesta de tiempo, consulte proponer nuevas horas de reunión.For more information on how to propose a time, and how to receive and accept a new time proposal, see Propose new meeting times.

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

Solicitud HTTPHTTP request

POST /me/events/{id}/tentativelyAccept
POST /users/{id | userPrincipalName}/events/{id}/tentativelyAccept

POST /me/calendar/events/{id}/tentativelyAccept
POST /users/{id | userPrincipalName}/calendar/events/{id}/tentativelyAccept

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

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

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

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 DescriptionDescription
commentcomment StringString Texto incluido en la respuesta. Opcional.Text included in the response. Optional.
proposedNewTimeproposedNewTime timeSlottimeSlot Fecha y hora alternativas propuestas por un invitado para que una convocatoria de reunión comience y finalice.An alternate date/time proposed by an invitee for a meeting request to start and end. Válido solo para eventos que permiten nuevas propuestas de tiempo.Valid only for events that allow new time proposals. Para establecer este parámetro, es necesario establecer sendResponse en true .Setting this parameter requires setting sendResponse to true. Opcional.Optional.
sendResponsesendResponse BooleanoBoolean true si se va a enviar una respuesta al organizador; de lo contrario, false. Opcional. El valor predeterminado es true.true if a response is to be sent to the organizer; otherwise, false. Optional. Default is true.

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.

Esta acción devuelve HTTP 400 si se produce una o ambas de las siguientes acciones:This action returns HTTP 400 if one or both of the following occur:

  • El parámetro proposedNewTime se incluye, pero la propiedad allowNewTimeProposals del evento es false .The proposedNewTime parameter is included but the allowNewTimeProposals property of the event is false.
  • El parámetro proposedNewTime se incluye, pero el parámetro sendResponse se establece en false .The proposedNewTime parameter is included but the sendResponse parameter is set to false.

EjemploExample

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

SolicitudRequest

En el siguiente ejemplo, el usuario que ha iniciado sesión responde provisionalmente al evento especificado, establece el parámetro sendResponse en true y incluye una hora alternativa en el parámetro proposedNewTime .In the following example, the signed-in user responds tentative to the specified event, sets the sendResponse parameter to true, and includes an alternative time in the proposedNewTime parameter.

POST https://graph.microsoft.com/v1.0/me/events/{id}/tentativelyAccept
Content-type: application/json

{
  "comment": "I may not be able to make this week. How about next week?",
  "sendResponse": true,
  "proposedNewTime": {
      "start": { 
          "dateTime": "2019-12-02T18:00:00", 
          "timeZone": "Pacific Standard Time" 
      }, 
      "end": { 
          "dateTime": "2019-12-02T19:00:00", 
          "timeZone": "Pacific Standard Time" 
      }     
  }
}

RespuestaResponse

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

HTTP/1.1 202 Accepted