Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Uma mensagem que representa uma solicitação, um cancelamento ou uma resposta de reunião. Os valores possíveis são: acceptance, tentative acceptance, ou decline.
A entidade eventMessage é derivada de message. eventMessage é o tipo base para eventMessageRequest e eventMessageResponse. A propriedade meetingMessageType identifica o tipo de mensagem do evento.
Quando um organizador ou aplicativo envia uma solicitação de reunião, a solicitação de reunião chega na caixa de correio do convidado como uma eventMessage instância com meetingMessageType de meetingRequest. Além disso, o Outlook cria automaticamente uma instância de evento no calendário do convidado, com a propriedade showAs como provisória.
Para obter as propriedades do evento associado na caixa de correio do convidado, o aplicativo pode usar a propriedade de navegação de eventos do eventMessage, conforme mostrado no exemplo get event message. O aplicativo também pode responder ao evento em nome do convidado programaticamente, aceitando, aceitando provisoriamente ou recusando o evento.
Além de uma solicitação de reunião, uma instância eventMessage pode ser encontrada na caixa de correio de um convidado como resultado de um organizador de eventos cancelando uma reunião ou na caixa de correio do organizador como resultado de um convidado respondendo à solicitação de reunião. Um aplicativo pode atuar em mensagens de evento da mesma maneira que atua em mensagens com poucas diferenças.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Get | eventMessage | Ler propriedades e relações do objeto eventMessage. |
| Update | eventMessage | Atualizar o objeto eventMessage. |
| Excluir | Nenhum | Excluir o objeto eventMessage. |
| Excluir permanentemente | Nenhum | Exclua permanentemente uma mensagem de evento e coloque-a na pasta limpezas na pasta Itens recuperáveis na caixa de correio do usuário. |
| Copiar mensagem | message | Copiar uma mensagem para uma pasta. |
| Criar rascunho para encaminhar mensagem | message | Criar um rascunho da mensagem de encaminhamento. Em seguida, você pode atualizar ou enviar esse rascunho. |
| Criar rascunho para responder | message | Criar um rascunho da mensagem de resposta. Em seguida, você pode atualizar ou enviar esse rascunho. |
| Criar rascunho para responder a todos | message | Criar um rascunho da mensagem Responder a Todos. Em seguida, você pode atualizar ou enviar esse rascunho. |
| Encaminhar mensagem | Nenhum | Encaminhar uma mensagem. A mensagem é então salva na pasta Itens Enviados. |
| Mover mensagem | message | Mover uma mensagem para uma pasta. Isso cria uma nova cópia da mensagem na pasta de destino. |
| Responder a uma mensagem. | Nenhum | Responder ao remetente de uma mensagem. A mensagem é então salva na pasta Itens Enviados. |
| Responder a todas as mensagens | Nenhum | Responder a todos os destinatários de uma mensagem. A mensagem é então salva na pasta Itens Enviados. |
| Enviar rascunho de mensagem | Nenhum | Envia um rascunho de mensagem anteriormente criado. A mensagem é então salva na pasta Itens Enviados. |
| Anexos | ||
| List attachments | Coleção attachment | Obtenha todos os anexos em um eventMessage. |
| Add attachment | attachment | Adicionar um novo anexo a um eventMessage postando na coleção attachments. |
| Extensões abertas | ||
| Criar extensão aberta | openTypeExtension | Criar uma extensão aberta e adicionar propriedades personalizadas em uma instância nova ou existente de um recurso. |
| Obter extensão aberta | Coleção openTypeExtension | Obter um ou mais objetos de extensão ou identificados por nome ou nome totalmente qualificado. |
| Propriedades estendidas | ||
| Criar uma propriedade de valor único | eventMessage | Criar uma ou mais propriedades estendidas de valor único em uma eventMessage nova ou existente. |
| Obter uma propriedade de valor único | eventMessage | Obter eventMessages que contenham uma propriedade estendida de valor único usando $expand ou $filter. |
| Criar propriedade de vários valores | eventMessage | Criar uma ou mais propriedades estendidas de vários valores em uma eventMessage nova ou existente. |
| Obter propriedade de vários valores | eventMessage | Obter um eventMessage que contenha uma propriedade estendida de vários valores usando $expand. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| bccRecipients | Coleção recipient | Os destinatários Cco: da mensagem. |
| body | itemBody | O corpo da mensagem. Pode estar no formato HTML ou no formato de texto. |
| bodyPreview | String | Os primeiros 255 caracteres do corpo da mensagem. Está no formato de texto. |
| categories | String collection | As categorias associadas à mensagem. |
| ccRecipients | Coleção recipient | Os destinatários Cc: da mensagem. |
| changeKey | String | A versão da mensagem. |
| conversationId | String | A ID da conversa à qual o email pertence. |
| conversationIndex | Edm.Binary | Indica a posição da mensagem dentro da conversa. |
| createdDateTime | DateTimeOffset | A data e a hora em que a mensagem foi criada. |
| flag | followupFlag | O valor do sinalizador que indica o status, a data de início, a data de conclusão ou a data de finalização da mensagem. |
| from | recipient | O proprietário da caixa de correio da qual a mensagem foi enviada. Na maioria dos casos, esse valor é o mesmo que o da propriedade remetente, exceto para cenários de compartilhamento ou delegação. O valor deve corresponder à caixa de correio real que foi usada. Saiba mais sobre como definir as propriedades from e sender de uma mensagem. |
| hasAttachments | Boolean | Indica se a mensagem tem anexos. |
| id | Cadeia de caracteres | Identificador exclusivo para a mensagem de evento.
Por padrão, esse valor muda quando o item é transferido de um contêiner (como uma pasta ou calendário) para outro. Para alterar esse comportamento, use o cabeçalho Prefer: IdType="ImmutableId". Para obter mais informações, consulte o artigo Obter identificadores imutáveis para recursos do Outlook. Somente leitura. |
| importância | String | A importância da mensagem: low, normal, high. |
| inferenceClassification | String | Os valores possíveis são: focused, e other. |
| internetMessageHeaders | Coleção internetMessageHeader | A coleção de cabeçalhos da mensagem, definida por RFC5322, que fornece detalhes do caminho de rede adotado por uma mensagem do remetente para o destinatário. Somente leitura. |
| internetMessageId | String | A ID da mensagem no formato especificado por RFC2822. |
| isDelegated | Booliano | Verdadeiro se esta solicitação de reunião estiver acessível a um representante; caso contrário, falso. O padrão é false. |
| isDeliveryReceiptRequested | Boolean | Indica se uma confirmação de leitura foi solicitada para a mensagem. |
| isDraft | Boolean | Indica se a mensagem é um rascunho. Uma mensagem será um rascunho se ainda não tiver sido enviada. |
| isRead | Boolean | Indica se a mensagem foi lida. |
| isReadReceiptRequested | Boolean | Indica se uma confirmação de leitura foi solicitada para a mensagem. |
| lastModifiedDateTime | DateTimeOffset | A data e a hora em que a mensagem foi alterada pela última vez. |
| meetingMessageType | meetingMessageType | O tipo de mensagem de evento: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTenativelyAccepted, meetingDeclined. |
| parentFolderId | String | O identificador exclusivo para a mailFolder pai da mensagem. |
| receivedDateTime | DateTimeOffset | A data e a hora em que a mensagem foi recebida. |
| replyTo | Coleção recipient | Os endereços de email a serem usados ao responder. |
| sender | recipient | A conta usada para gerar a mensagem. Na maioria dos casos, esse valor é o mesmo da propriedade from. Você pode definir essa propriedade como um valor diferente ao enviar uma mensagem de uma caixa de correio compartilhada, ou ao enviar uma mensagem como um delegado. De qualquer forma, o valor deve corresponder à caixa de correio real que foi usada. Saiba mais sobre como definir as propriedades from e sender de uma mensagem. |
| sentDateTime | DateTimeOffset | A data e a hora em que a mensagem foi enviada. |
| subject | String | O assunto da mensagem. |
| toRecipients | Coleção recipient | Os destinatários Para: da mensagem. |
| uniqueBody | itemBody | A parte do corpo da mensagem que é exclusiva para a mensagem atual. |
| webLink | String | O URL para abrir a mensagem no Outlook na Web. Você pode acrescentar um ispopout argumento ao final da URL para alterar a forma como a mensagem é exibida. Se ispopout não estiver presente ou se estiver definido como 1, a mensagem será mostrada em uma janela pop-out. Se ispopout for definido como 0, o navegador mostrará a mensagem no painel de revisão do Outlook na Web.A mensagem será aberta no navegador se você estiver conectado à caixa de correio via Outlook na Web. Você será solicitado a entrar se ainda não tiver entrado com o navegador. Esta URL não pode ser acessada de dentro de um iFrame. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| attachments | Coleção attachment | Somente leitura. Anulável. |
| event | event | O evento associado à mensagem de evento. A pressuposição dos participantes ou recursos da sala é que o Atendedor de Calendário esteja definido para atualizar automaticamente o calendário com um evento quando mensagens de evento de solicitação de reunião chegarem. Propriedade de navegação. Somente leitura. |
| extensions | Coleção extension | A coleção de extensões abertas definidas para o eventMessage. Somente leitura. Anulável. |
| multiValueExtendedProperties | Coleção multiValueLegacyExtendedProperty | A coleção de propriedades estendidas de vários valores definidas para a eventMessage. Somente leitura. Anulável. |
| singleValueExtendedProperties | Coleção singleValueLegacyExtendedProperty | A coleção de propriedades estendidas de valor único definidas para a eventMessage. Somente leitura. Anulável. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"bccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"body": {"@odata.type": "microsoft.graph.itemBody"},
"bodyPreview": "string",
"categories": ["string"],
"ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"changeKey": "string",
"conversationId": "string",
"conversationIndex": "String (binary)",
"createdDateTime": "DateTimeOffset",
"event": { "@odata.type": "microsoft.graph.event" },
"flag": {"@odata.type": "microsoft.graph.followupFlag"},
"from": {"@odata.type": "microsoft.graph.recipient"},
"hasAttachments": true,
"id": "string (identifier)",
"importance": "String",
"inferenceClassification": "String",
"internetMessageHeaders": [{"@odata.type": "microsoft.graph.internetMessageHeader"}],
"internetMessageId": "String",
"isDelegated": true,
"isDeliveryReceiptRequested": true,
"isDraft": true,
"isRead": true,
"isReadReceiptRequested": true,
"lastModifiedDateTime": "DateTimeOffset",
"meetingMessageType": "String",
"parentFolderId": "string",
"receivedDateTime": "DateTimeOffset",
"replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
"sender": {"@odata.type": "microsoft.graph.recipient"},
"sentDateTime": "DateTimeOffset",
"subject": "string",
"toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
"webLink": "string"
}