Nachrichtenressourcentypmessage resource type

Dieser Ressourcentyp stellt eine Nachricht in einem mailFolder-Objekt dar.A message in a mailFolder.

Diese Ressource unterstützt Folgendes:This resource supports:

  • Hinzufügen von Ihren eigenen Daten als benutzerdefinierte Internetkopfzeilen Nachricht.Adding your own data as custom Internet message headers. Benutzerdefinierte Header nur beim Erstellen einer Nachricht hinzufügen, und nennen Sie sie beginnend mit "x-".Add custom headers only when creating a message, and name them starting with "x-". Nachdem die Nachricht gesendet wurde, können Sie die Kopfzeilen nicht ändern.Once the message has been sent, you cannot modify the headers. Wenn die Kopfzeilen der Nachricht erhalten möchten, gelten die $select Abfragen Parameter in einem Vorgang Meldung wird angezeigt .To get the headers of a message, apply the $select query parameter in a get message operation.
  • Hinzufügen von Ihren eigenen Daten als benutzerdefinierte Eigenschaften als Extensions.Adding your own data as custom properties as extensions.
  • Abonnieren von Benachrichtigungen zu ändern.Subscribing to change notifications.
  • Verwenden einer Delta-Abfrage zum Nachverfolgen von inkrementellen Hinzufügungen, Löschungen und Aktualisierungen durch Bereitstellen der delta-Funktion.Using delta query to track incremental additions, deletions, and updates, by providing a delta function.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Nachrichten auflistenList messages Sammlung von Nachrichtenmessage collection Dient zum Abrufen aller Nachrichten im Postfach des angemeldeten Benutzers (einschließlich der Ordner „Gelöschte Elemente“ und „Clutter“).Get all the messages in the signed-in user's mailbox (including the Deleted Items and Clutter folders).
Nachricht erstellenCreate message Nachrichtmessage Erstellt einen Entwurf einer neuen Nachricht.Create a draft of a new message.
Nachricht abrufenGet message Nachrichtmessage Liest Eigenschaften und Beziehungen des Nachrichtenobjekts.Read properties and relationships of message object.
AktualisierenUpdate Nachrichtmessage Aktualisiert das Nachrichtenobjekt.Update message object.
LöschenDelete KeinerNone Löscht das Nachrichtenobjekt.Delete message object.
Kopierencopy NachrichtMessage Kopiert eine Nachricht in einen Ordner.Copy a message to a folder.
createForwardcreateForward NachrichtMessage Erstellt einen Entwurf der Weiterleitungsnachricht. Sie können den Entwurf dann aktualisieren oder senden.Create a draft of the Forward message. You can then update or send the draft.
createReplycreateReply NachrichtMessage Erstellt einen Entwurf der Antwortnachricht. Sie können den Entwurf dann aktualisieren oder senden.Create a draft of the Reply message. You can then update or send the draft.
createReplyAllcreateReplyAll NachrichtMessage Erstellt einen Entwurf der „Allen Antworten“-Nachricht. Sie können den Entwurf dann aktualisieren oder senden.Create a draft of the Reply All message. You can then update or send the draft.
deltadelta message-Sammlungmessage collection Dient zum Abrufen eines Satzes von Nachrichten, die einem bestimmten Ordner hinzugefügt bzw. daraus gelöscht oder darin aktualisiert wurden.Get a set of messages that have been added, deleted, or updated in a specified folder.
forwardforward KeineNone Leitet eine Nachricht weiter. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.Forward a message. The message is then saved in the Sent Items folder.
Verschiebenmove NachrichtMessage Verschiebt eine Nachricht in einen Ordner. Dadurch wird eine neue Kopie der Nachricht im Zielordner erstellt.Move the message to a folder. This creates a new copy of the message in the destination folder.
Antwortenreply KeineNone Antwortet auf eine Nachricht des Absenders. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.Reply to the sender of a message. The message is then saved in the Sent Items folder.
replyAllreplyAll KeineNone Sendet eine Antwort an alle Empfänger einer E-Mail. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.Reply to all recipients of a message. The message is then saved in the Sent Items folder.
Sendensend KeineNone Sendet einen zuvor erstellten Nachrichtenentwurf. Die Nachricht wird dann im Ordner „Gesendete Elemente“ gespeichert.Sends a previously created message draft. The message is then saved in the Sent Items folder.
AnlagenAttachments
Anlagen auflistenList attachments AnlagensammlungAttachment collection Ruft alle Anlagen in einer Nachricht ab.Gets all attachments on a message.
Hinzufügen einer AnlageAdd attachment AnlageAttachment Fügt einer Nachricht eine neue Anlage durch Veröffentlichen in der Anlagensammlung hinzu.Add a new attachment to a message by posting to the attachments collection.
Offene ErweiterungenOpen extensions
Offene Erweiterung erstellenCreate open extension openTypeExtensionopenTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften in einer neuen oder vorhandenen Instanz einer Ressource hinzu.Create an open extension and add custom properties in a new or existing instance of a resource.
Offene Erweiterung abrufenGet open extension openTypeExtension-SammlungopenTypeExtension collection Ruft ein offenes Erweiterungsobjekt oder Objekte basierend auf ihrem Namen oder vollqualifizierten Namen ab.Get an open extension object or objects identified by name or fully qualified name.
SchemaerweiterungenSchema extensions
Schemaerweiterungswerte hinzufügenAdd schema extension values Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.Create a schema extension definition and then use it to add custom typed data to a resource.
Erweiterte EigenschaftenExtended properties
Einwertige erweiterte Eigenschaft erstellenCreate single-value extended property Nachrichtmessage Erstellt eine oder mehrere einwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Nachricht.Create one or more single-value extended properties in a new or existing message.
Nachricht mit einwertiger erweiterter Eigenschaft abrufenGet message with single-value extended property Nachrichtmessage Ruft mithilfe von $expand oder $filter Nachrichten mit einer einwertigen erweiterten Eigenschaft ab.Get messages that contain a single-value extended property by using $expand or $filter.
Mehrwertige erweiterte Eigenschaft erstellenCreate multi-value extended property Nachrichtmessage Erstellt eine oder mehrere mehrwertige erweiterte Eigenschaften in einer neuen oder vorhandenen Nachricht.Create one or more multi-value extended properties in a new or existing message.
Nachricht mit mehrwertiger erweiterter Eigenschaft abrufenGet message with multi-value extended property Nachrichtmessage Ruft eine Nachricht mit einer mehrwertigen erweiterten Eigenschaft mithilfe von $expand ab.Get a message that contains a multi-value extended property by using $expand.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
bccRecipientsbccRecipients recipient collectionrecipient collection Die Bcc:-Empfänger der Nachricht.The Bcc: recipients for the message.
bodybody itemBodyitemBody Der Text der Nachricht.The body of the message. Es kann im HTML- oder Textformat sein.It can be in HTML or text format. Erfahren Sie mehr über sichere HTML-Code in den Textkörper einer Nachricht.Find out about safe HTML in a message body.
bodyPreviewbodyPreview StringString Die ersten 255 Zeichen des Nachrichtentexts. Liegt im Textformat vor.The first 255 characters of the message body. It is in text format.
categoriescategories ZeichenfolgenauflistungString collection Die Kategorien, die mit der Nachricht verknüpft sind.The categories associated with the message.
ccRecipientsccRecipients recipient collectionrecipient collection Die Cc:-Empfänger der Nachricht.The Cc: recipients for the message.
changeKeychangeKey StringString Die Version der Nachricht.The version of the message.
conversationIdconversationId StringString Die ID der Unterhaltung, zu der die E-Mail gehört.The ID of the conversation the email belongs to.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht erstellt wurde.The date and time the message was created.
Flagflag followupFlagfollowupFlag Der Wert des Flags, der den Status, das Startdatum, das Fälligkeitsdatum oder das Enddatum für die Nachricht angibt.The flag value that indicates the status, start date, due date, or completion date for the message.
Vonfrom Empfängerrecipient Der Postfachbesitzer und der Absender der Nachricht.The mailbox owner and sender of the message. Der Wert muss in das tatsächliche Postfach verwendet entsprechen.The value must correspond to the actual mailbox used. Erfahren Sie mehr über Einstellung der aus und Absender Eigenschaften einer Nachricht.Find out more about setting the from and sender properties of a message.
hasAttachmentshasAttachments Boolescher WertBoolean Gibt an, ob die Nachricht Anlagen enthält. Diese Eigenschaft enthält keine Inline-Anlagen, wenn eine Nachrichtalso nur Inline-Anlagen enthält, ist diese Eigenschaft „false“. Um das Vorhandensein von Inline-Anlagen zu überprüfen, analysieren Sie die body-Eigenschaft so, dass nach einem src-Attribut, z. B. <IMG src="cid:image001.jpg@01D26CD8.6C05F070">, gesucht wird.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 Eindeutiger Bezeichner für die Nachricht (beachten Sie, dass sich dieser Wert ändern kann, wenn eine Nachricht verschoben oder geändert wird)Unique identifier for the message (note that this value may change if a message is moved or altered)
Wichtigkeitimportance Wichtigkeitimportance Wichtigkeit der Nachricht: Low, Normal, High.The importance of the message: Low, Normal, High.
inferenceClassificationinferenceClassification inferenceClassificationTypeinferenceClassificationType Die Klassifizierung der Nachricht für Benutzer, basierend auf abgeleiteten Relevanz oder Wichtigkeit oder auf eine explizite Außerkraftsetzung vorliegt.The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. Die möglichen Werte sind: focused oder other.The possible values are: focused or other.
internetMessageHeadersinternetMessageHeaders internetinternetMessageHeaders-SammlunginternetMessageHeader collection Eine Auflistung von Nachrichtenkopfzeilen von RFC5322definiert.A collection of message headers defined by RFC5322. Der Satz enthält Nachrichtenkopfzeilen zurück, der den Netzwerkpfad durch eine Nachricht vom Absender an den Empfänger angibt.The set includes message headers indicating the network path taken by a message from the sender to the recipient. Sie können auch benutzerdefinierte Nachrichtenkopfzeilen enthalten, die die app-Daten für die Nachricht enthalten.It can also contain custom message headers that hold app data for the message.
internetMessageIdinternetMessageId StringString Die Nachrichten-ID im von RFC2822 angegebenen Format.The message ID in the format specified by RFC2822.
isDeliveryReceiptRequestedisDeliveryReceiptRequested Boolescher WertBoolean Zeigt an, ob für die Nachricht eine Lesebestätigung angefordert wird.Indicates whether a read receipt is requested for the message.
isDraftisDraft Boolescher WertBoolean Gibt an, ob die Nachricht ein Entwurf ist. Eine Nachricht ist ein Entwurf, solange sie noch nicht gesendet wurde.Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet.
isReadisRead Boolescher WertBoolean Gibt an, ob die Nachricht gelesen wurde.Indicates whether the message has been read.
isReadReceiptRequestedisReadReceiptRequested Boolescher WertBoolean Zeigt an, ob für die Nachricht eine Lesebestätigung angefordert wird.Indicates whether a read receipt is requested for the message.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht zuletzt geändert wurde.The date and time the message was last changed.
parentFolderIdparentFolderId StringString Der eindeutige Bezeichner für das übergeordnete mailFolder-Element der Nachricht.The unique identifier for the message's parent mailFolder.
receivedDateTimereceivedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht erhalten wurde.The date and time the message was received.
replyToreplyTo recipient collectionrecipient collection Die E-Mail-Adressen, die beim Antworten verwendet werden sollen.The email addresses to use when replying.
sendersender Empfängerrecipient Das Konto, das tatsächlich verwendet wird, um die Nachricht zu generieren.The account that is actually used to generate the message. In den meisten Fällen beträgt dieser Wert von -Eigenschaft identisch.In most cases, this value is the same as the from property. Sie können diese Eigenschaft auf einen anderen Wert festlegen, beim Senden einer Nachricht von einem freigegebenen Postfachoder Senden einer Nachricht als Delegieren.You can set this property to a different value when sending a message from a shared mailbox, or sending a message as a delegate. Der Wert muss in jedem Fall das tatsächliche Postfach verwendet entsprechen.In any case, the value must correspond to the actual mailbox used. Erfahren Sie mehr über Einstellung der aus und Absender Eigenschaften einer Nachricht.Find out more about setting the from and sender properties of a message.
sentDateTimesentDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit, zu der die Nachricht gesendet wurde.The date and time the message was sent.
Betreffsubject StringString Der Betreff der Nachricht.The subject of the message.
toRecipientstoRecipients recipient collectionrecipient collection Die An:-Empfänger der Nachricht.The To: recipients for the message.
uniqueBodyuniqueBody itemBodyitemBody Der Teil des Nachrichtentexts, der nur in der aktuellen Nachricht vorhanden ist. uniqueBody wird nicht standardmäßig zurückgegeben, kann aber für eine bestimmte Nachricht mithilfe der Abfrage ?$select=uniqueBody abgerufen werden. Er kann im HTML- oder Textformat vorliegen.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 Die URL zum Öffnen der Nachricht in Outlook Web App.The URL to open the message in Outlook Web App.

Sie können am Ende der URL das Argument „ispopout“ anhängen, um zu ändern, wie die Nachricht angezeigt wird. Wenn „ispopout“ nicht vorhanden oder auf 1 festgelegt ist, wird die Nachricht in einem Popout-Fenster angezeigt. Wenn „ispopout“ auf 0 festgelegt ist, zeigt der Browser die Nachricht in Outlook Web App im Prüffensterbereich an.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser will show the message in the Outlook Web App review pane.

Die Nachricht wird im Browser geöffnet, wenn Sie über Outlook Web App bei Ihrem Postfach angemeldet sind. Sie werden aufgefordert, sich anzumelden, wenn Sie noch nicht beim Browser angemeldet sind.The message will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

Auf diese URL kann von einem iFrame aus zugegriffen werden.This URL can be accessed from within an iFrame.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
attachmentsattachments attachment-Sammlungattachment collection Die fileAttachment- und itemAttachment-Anlagen der Nachricht.The fileAttachment and itemAttachment attachments for the message.
Erweiterungenextensions extension-Sammlungextension collection Die Sammlung der für die Nachricht definierten offenen Erweiterungen. Schreibgeschützt. Lässt NULL-Werte zu.The collection of open extensions defined for the message. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty-SammlungmultiValueLegacyExtendedProperty collection Die Sammlung der für die Nachricht definierten mehrwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt NULL-Werte zu.The collection of multi-value extended properties defined for the message. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty-SammlungsingleValueLegacyExtendedProperty collection Die Sammlung der für die Nachricht definierten einwertigen erweiterten Eigenschaften. Schreibgeschützt. Lässt Nullwerte zu.The collection of single-value extended properties defined for the message. Read-only. Nullable.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here 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",
  "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"}]
}

Siehe auchSee also