event: tentativelyAccept

Namespace: microsoft.graph

Aceite provisamente o evento especificado em um calendário do usuário.

Se o evento permitir propostas para novos horários, ao responder provisão ao evento, um convidado pode optar por sugerir uma hora alternativa incluindo o parâmetro proposedNewTime . Para obter mais informações sobre como propor um horário e como receber e aceitar uma nova proposta de hora, consulte Propor novos horários de reunião.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Calendars.ReadWrite
Delegado (conta pessoal da Microsoft) Calendars.ReadWrite
Aplicativo Calendars.ReadWrite

Solicitação HTTP

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/calendargroups/{id}/calendars/{id}/events/{id}/tentativelyAccept
POST /users/{id | userPrincipalName}/calendargroups/{id}/calendars/{id}/events/{id}/tentativelyAccept

Cabeçalhos de solicitação

Nome Tipo Descrição
Autorização string {token} de portador. Obrigatório.
Content-Type string Natureza dos dados no corpo de uma entidade. Obrigatório.

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Parâmetro Tipo Descrição
comment String Texto incluído na resposta. Opcional.
proposedNewTime timeSlot Uma data/hora alternativa proposta por um convidado para que uma solicitação de reunião seja inicial e final. Válido somente para eventos que permitem novas propostas de tempo. A configuração desse parâmetro requer a definição de sendResponse como true. Opcional.
sendResponse Booliano true se uma resposta deve ser enviada ao organizador; caso contrário, false. Opcional. O padrão é true.

Resposta

Se bem-sucedido, este método retorna um código de resposta 202 Accepted. Não retorna nada no corpo da resposta.

Essa ação retornará HTTP 400 se ocorrer um ou ambos os seguintes:

  • O parâmetro proposedNewTime está incluído, mas a propriedade allowNewTimeProposals do evento é false.
  • O parâmetro proposedNewTime está incluído, mas o parâmetro sendResponse é definido como false.

Exemplo

Eis um exemplo de como chamar esta API.

Solicitação

No exemplo a seguir, o usuário in-loco responde provisivo ao evento especificado, define o parâmetro sendResponse como true e inclui uma hora alternativa no parâmetro proposedNewTime .

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" 
      }     
  }
}

Resposta

Veja a seguir um exemplo da resposta.

HTTP/1.1 202 Accepted