tipo de recurso de mensagemmessage resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Uma mensagem em uma mailFolder.A message in a mailFolder.

O número total máximo de destinatários incluídos nas propriedades toRecipients, ccRecipients e bccRecipients para uma única mensagem de email enviada de uma caixa de correio do Exchange A é de 500.The maximum total number of recipients included in the toRecipients, ccRecipients, and bccRecipients properties for a single email message sent from an Exchange Online mailbox is 500. Para obter mais informações, veja limites de envio.For more information, see sending limits.

Esse recurso permite:This resource supports:

  • Adicionar seus próprios dados como cabeçalhos personalizados de mensagens da Internet.Adding your own data as custom Internet message headers. Adicionar cabeçalhos personalizados somente ao criar uma mensagem e nomes que começam com"x-".Add custom headers only when creating a message, and name them starting with "x-". Após a mensagem ter sido enviada, não será possível alterar os cabeçalhos.Once the message has been sent, you cannot modify the headers. Para obter os cabeçalhos de uma mensagem, aplique o parâmetro de consulta $select em uma operação get message.To get the headers of a message, apply the $select query parameter in a get message operation.
  • Adicionar seus próprios dados como propriedades personalizadas como extensions.Adding your own data as custom properties as extensions.
  • Assinar as notificações de alteração.Subscribing to change notifications.
  • Usar a consulta delta para controlar adições, exclusões e atualizações incrementais oferecendo uma função delta.Using delta query to track incremental additions, deletions, and updates, by providing a delta function.

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Listar mensagensList messages Coleção messagemessage collection Obter todas as mensagens na caixa de correio do usuário conectado (incluindo as pastas Itens Excluídos e Email Secundário).Get all the messages in the signed-in user's mailbox (including the Deleted Items and Clutter folders).
Criar mensagemCreate message messagemessage Criar um rascunho de uma nova mensagem.Create a draft of a new message.
Obter mensagemGet message messagemessage Ler propriedades e relações do objeto mensage.Read properties and relationships of message object.
UpdateUpdate messagemessage Atualizar o objeto message.Update message object.
DeleteDelete NoneNone Excluir o objeto message.Delete message object.
copycopy MessageMessage Copiar uma mensagem para uma pasta.Copy a message to a folder.
createForwardcreateForward MessageMessage Criar um rascunho da mensagem de encaminhamento. Em seguida, você pode atualizar ou enviar esse rascunho.Create a draft of the Forward message. You can then update or send the draft.
createReplycreateReply MessageMessage Criar um rascunho da mensagem de resposta. Em seguida, você pode atualizar ou enviar esse rascunho.Create a draft of the Reply message. You can then update or send the draft.
createReplyAllcreateReplyAll MessageMessage Criar um rascunho da mensagem Responder a Todos. Em seguida, você pode atualizar ou enviar esse rascunho.Create a draft of the Reply All message. You can then update or send the draft.
deltadelta Coleção messagemessage collection Obtenha um conjunto de mensagens que foram adicionadas, excluídas ou atualizadas em uma pasta especificada.Get a set of messages that have been added, deleted, or updated in a specified folder.
forwardforward NenhumNone Encaminhar uma mensagem. A mensagem é então salva na pasta Itens Enviados.Forward a message. The message is then saved in the Sent Items folder.
movemove MessageMessage Mover a mensagem para uma pasta. Isso cria uma nova cópia da mensagem na pasta de destino.Move the message to a folder. This creates a new copy of the message in the destination folder.
replyreply NenhumNone Responder ao remetente de uma mensagem. A mensagem é então salva na pasta Itens Enviados.Reply to the sender of a message. The message is then saved in the Sent Items folder.
replyAllreplyAll NenhumNone Responder a todos os destinatários de uma mensagem. A mensagem é então salva na pasta Itens Enviados.Reply to all recipients of a message. The message is then saved in the Sent Items folder.
sendsend NenhumNone Envia um rascunho de mensagem anteriormente criado. A mensagem é então salva na pasta Itens Enviados.Sends a previously created message draft. The message is then saved in the Sent Items folder.
AnexosAttachments
Listar anexosList attachments Coleção AttachmentAttachment collection Obtém todos os anexos em uma mensagem.Gets all attachments on a message.
Add attachmentAdd attachment AttachmentAttachment Adicione um novo anexo a uma mensagem postando na coleção attachments.Add a new attachment to a message by posting to the attachments collection.
Extensões abertasOpen extensions
Criar extensão abertaCreate open extension openTypeExtensionopenTypeExtension Criar uma extensão aberta e adicionar propriedades personalizadas em uma instância nova ou existente de um recurso.Create an open extension and add custom properties in a new or existing instance of a resource.
Obter extensão abertaGet open extension Coleção openTypeExtensionopenTypeExtension collection Obter um ou mais objetos de extensão ou identificados por nome ou nome totalmente qualificado.Get an open extension object or objects identified by name or fully qualified name.
Extensões de esquemaSchema extensions
Adicionar valores de extensões de esquemaAdd schema extension values Cria uma definição para a extensão de esquema e usa-a para adicionar dados digitados personalizados a um recurso.Create a schema extension definition and then use it to add custom typed data to a resource.
Propriedades estendidasExtended properties
Criar uma propriedade estendida de valor únicoCreate single-value extended property messagemessage Criar uma ou mais propriedades estendidas de valor único em uma mensagem nova ou existente.Create one or more single-value extended properties in a new or existing message.
Obter mensagem com propriedade estendida de valor únicoGet message with single-value extended property messagemessage Obter mensagens que contenham uma propriedade estendida de valor único usando $expand ou $filter.Get messages that contain a single-value extended property by using $expand or $filter.
Criar propriedade estendida de vários valoresCreate multi-value extended property messagemessage Criar uma ou mais propriedades estendidas de vários valores em uma mensagem nova ou existente.Create one or more multi-value extended properties in a new or existing message.
Obter mensagem com propriedade estendida de vários valoresGet message with multi-value extended property messagemessage Obter uma mensagem que contenha uma propriedade estendida de vários valores usando $expand.Get a message that contains a multi-value extended property by using $expand.

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
bccRecipientsbccRecipients Coleção recipientrecipient collection Os destinatários Cco: da mensagem.The Bcc: recipients for the message.
bodybody itemBodyitemBody O corpo da mensagem.The body of the message. Pode estar no formato HTML ou no formato de texto.It can be in HTML or text format. Saiba mais sobre HTML seguro no corpo da mensagem.Find out about safe HTML in a message body.
bodyPreviewbodyPreview StringString Os primeiros 255 caracteres do corpo da mensagem. Está no formato de texto.The first 255 characters of the message body. It is in text format.
categoriescategories String collectionString collection As categorias associadas à mensagem.The categories associated with the message.
ccRecipientsccRecipients Coleção recipientrecipient collection Os destinatários Cc: da mensagem.The Cc: recipients for the message.
changeKeychangeKey StringString A versão da mensagem.The version of the message.
conversationIdconversationId StringString A ID da conversa à qual o email pertence.The ID of the conversation the email belongs to.
conversationIndexconversationIndex Edm.BinaryEdm.Binary Indica a posição da mensagem dentro da conversa.Indicates the position of the message within the conversation.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset A data e a hora em que a mensagem foi criada.The date and time the message was created.

As informações de data e hora usam o formato ISO 8601 e estão sempre no horário UTC.The date and time information uses ISO 8601 format and is always in UTC time. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
flagflag followupFlagfollowupFlag 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.The flag value that indicates the status, start date, due date, or completion date for the message.
fromfrom recipientrecipient O proprietário da caixa de correio da qual a mensagem foi enviada.The owner of the mailbox from which the message is sent. Na maioria dos casos, esse valor é o mesmo que o da propriedade remetente, exceto para cenários de compartilhamento ou delegação.In most cases, this value is the same as the sender property, except for sharing or delegation scenarios. O valor deve corresponder à caixa de correio real que foi usada.The value must correspond to the actual mailbox used. Saiba mais sobre como definir as propriedades from e sender de uma mensagem.Find out more about setting the from and sender properties of a message.
hasAttachmentshasAttachments BoolianoBoolean Indica se a mensagem tem anexos. Esta propriedade não inclui anexos em linha, portanto, se uma mensagem contém somente anexos em linha, essa propriedade é falsa. Para verificar a existência de anexos em linha, analise a propriedade body para procurar um atributo src, como <IMG src="cid:image001.jpg@01D26CD8.6C05F070">.Indicates whether the message has attachments. This property doesn't include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as <IMG src="cid:image001.jpg@01D26CD8.6C05F070">.
idid StringString Identificador exclusivo da mensagem (observe que esse valor pode mudar se uma mensagem é movida ou alterada)Unique identifier for the message (note that this value may change if a message is moved or altered)
importanceimportance importânciaimportance A importância da mensagem.The importance of the message. Os valores possíveis são low, normal e high.The possible values are: low, normal, and high.
inferenceClassificationinferenceClassification inferenceClassificationTypeinferenceClassificationType A classificação da mensagem para o usuário, com base na relevância ou importância deduzida, ou em uma substituição explícita.The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. Os valores possíveis são: focused ou other.The possible values are: focused or other.
internetMessageHeadersinternetMessageHeaders Coleção internetMessageHeaderinternetMessageHeader collection Uma coleção de cabeçalhos de mensagens definidos por RFC5322.A collection of message headers defined by RFC5322. O conjunto inclui cabeçalhos de mensagens que indicam o caminho de rede adotado por uma mensagem do remetente para o destinatário.The set includes message headers indicating the network path taken by a message from the sender to the recipient. Também pode conter cabeçalhos de mensagens personalizados com dados do aplicativo para a mensagem.It can also contain custom message headers that hold app data for the message.

Retornado apenas mediante aplicação da opção de consulta $select.Returned only on applying a $select query option. Somente leitura.Read-only.
internetMessageIdinternetMessageId StringString A ID da mensagem no formato especificado por RFC2822.The message ID in the format specified by RFC2822.
isDeliveryReceiptRequestedisDeliveryReceiptRequested BooleanBoolean Indica se uma confirmação de leitura foi solicitada para a mensagem.Indicates whether a read receipt is requested for the message.
isDraftisDraft BooleanBoolean Indica se a mensagem é um rascunho. Uma mensagem é um rascunho quando ela ainda não foi enviada.Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet.
isReadisRead BooleanBoolean Indica se a mensagem foi lida.Indicates whether the message has been read.
isReadReceiptRequestedisReadReceiptRequested BooleanBoolean Indica se uma confirmação de leitura foi solicitada para a mensagem.Indicates whether a read receipt is requested for the message.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset A data e a hora em que a mensagem foi alterada pela última vez.The date and time the message was last changed.

As informações de data e hora usam o formato ISO 8601 e estão sempre no horário UTC.The date and time information uses ISO 8601 format and is always in UTC time. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
parentFolderIdparentFolderId StringString O identificador exclusivo para a mailFolder pai da mensagem.The unique identifier for the message's parent mailFolder.
receivedDateTimereceivedDateTime DateTimeOffsetDateTimeOffset A data e a hora em que a mensagem foi recebida.The date and time the message was received.

As informações de data e hora usam o formato ISO 8601 e estão sempre no horário UTC.The date and time information uses ISO 8601 format and is always in UTC time. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
replyToreplyTo Coleção recipientrecipient collection Os endereços de email a serem usados ao responder.The email addresses to use when replying.
sendersender recipientrecipient A conta que é realmente usada para gerar a mensagem.The account that is actually used to generate the message. Na maioria dos casos, esse valor é o mesmo da propriedade from.In most cases, this value is the same as the from property. 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.You can set this property to a different value when sending a message from a shared mailbox, for a shared calendar, or as a delegate. De qualquer forma, o valor deve corresponder à caixa de correio real que foi usada.In any case, the value must correspond to the actual mailbox used. Saiba mais sobre como definir as propriedades from e sender de uma mensagem.Find out more about setting the from and sender properties of a message.
sentDateTimesentDateTime DateTimeOffsetDateTimeOffset A data e a hora em que a mensagem foi enviada.The date and time the message was sent.

As informações de data e hora usam o formato ISO 8601 e estão sempre no horário UTC.The date and time information uses ISO 8601 format and is always in UTC time. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
assuntosubject StringString O assunto da mensagem.The subject of the message.
toRecipientstoRecipients Coleção recipientrecipient collection Os destinatários Para: da mensagem.The To: recipients for the message.
uniqueBodyuniqueBody itemBodyitemBody A parte do corpo da mensagem que é exclusiva para a mensagem atual. uniqueBody não é fornecido por padrão, mas pode ser recuperado por uma determinada mensagem pelo uso da consulta ?$select=uniqueBody. Pode estar no formato HTML ou no formato de texto.The part of the body of the message that is unique to the current message. uniqueBody is not returned by default but can be retrieved for a given message by use of the ?$select=uniqueBody query. It can be in HTML or text format.
webLinkwebLink StringString O URL para abrir a mensagem no Outlook na Web.The URL to open the message in Outlook on the web.

Você pode acrescentar um argumento ispopout ao final da URL para alterar como a mensagem é exibida.You can append an ispopout argument to the end of the URL to change how the message is displayed. Se ispopout não houver presente ou estiver definido como 1, a mensagem será mostrada em uma janela pop-up.If ispopout is not present or if it is set to 1, then the message is shown in a popout window. Se a entrada for definida como 0, o navegador mostrará a mensagem no painel de revisão do Outlook na Web.If ispopout is set to 0, then the browser will show the message in the Outlook on the web review pane.

A mensagem será aberta no navegador se você estiver conectado à sua caixa de correio através do Outlook na Web.The message will open in the browser if you are logged in to your mailbox via Outlook on the web. Você será solicitado a fazer o login, se ainda não estiver conectado com o navegador.You will be prompted to login if you are not already logged in with the browser.

Este URL não pode ser acessado a partir de um iFrame.This URL cannot be accessed from within an iFrame.

RelaçõesRelationships

RelaçãoRelationship TipoType DescriçãoDescription
attachmentsattachments Coleção attachmentattachment collection Os anexos fileAttachment e itemAttachment da mensagem.The fileAttachment and itemAttachment attachments for the message.
extensionsextensions Coleção extensionextension collection A coleção de extensões abertas definidas para a mensagem.The collection of open extensions defined for the message. Anulável.Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties Coleção multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection A coleção de propriedades estendidas de vários valores definidas para a mensagem.The collection of multi-value extended properties defined for the message. Anulável.Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties Coleção singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection A coleção de propriedades estendidas de valor único definidas para a mensagem.The collection of single-value extended properties defined for the message. Anulável.Nullable.

Representação JSONJSON representation

Veja a seguir uma representação JSON do recursoHere is a JSON representation of the resource

{
  "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": "String (timestamp)",
  "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",
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "String (timestamp)",
  "parentFolderId": "string",
  "receivedDateTime": "String (timestamp)",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "String (timestamp)",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "webLink": "string",

  "attachments": [{"@odata.type": "microsoft.graph.attachment"}],
  "extensions": [{"@odata.type": "microsoft.graph.extension"}],
  "multiValueExtendedProperties": [{"@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty"}],
  "singleValueExtendedProperties": [{"@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty"}]
}

Confira tambémSee also