event: tentativelyAccept

Namespace: microsoft.graph

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

Se o evento permitir propostas para novos horários, ao responder provisoriamente ao evento, um convidado poderá optar por sugerir um horário alternativo 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 horário, consulte Propor novos horários de reunião.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

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

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. Saiba mais sobre autenticação e autorização.
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 comece e termine. Válido apenas para eventos que permitam novas propostas de horários. A configuração desse parâmetro requer a configuraçã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. Ele não retorna nada no corpo da resposta.

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

  • 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 está definido como false.

Exemplo

Eis um exemplo de como chamar esta API.

Solicitação

No exemplo a seguir, o usuário conectado responde provisoriamente ao evento especificado, define o parâmetro sendResponse como true e inclui um horário alternativo 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

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted