event: decline

Namespace: microsoft.graph

Recusar convite para o evento especificado em um calendário do usuário.

Se o evento permitir propostas para novos horários, ao recusar o 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}/decline
POST /users/{id | userPrincipalName}/events/{id}/decline

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

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

POST /me/calendarGroups/{id}/calendars/{id}/events/{id}/decline
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{id}/decline

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

O exemplo a seguir mostra uma solicitação.

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

{
  "comment": "I won't 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