Nachricht aktualisieren

Namespace: microsoft.graph

Mit dieser API können Sie die Eigenschaften eines Nachrichtenobjekts aktualisieren.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Mail.ReadWrite
Delegiert (persönliches Microsoft-Konto)	Mail.ReadWrite
Anwendung	Mail.ReadWrite

HTTP-Anforderung

PATCH /me/messages/{id}
PATCH /users/{id | userPrincipalName}/messages/{id}
PATCH /me/mailFolders/{id}/messages/{id}
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}

Anforderungsheader

Name	Typ	Beschreibung
Authorization	string	Bearer {token}. Erforderlich.
Content-Type	string	Die Art der Daten im Textkörper einer Entität. Erforderlich.

Anforderungstext

Geben Sie im Hauptteil der Anforderung die Werte für relevante Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Hauptteil der Anforderung enthalten sind, behalten ihre vorherigen Werte bei oder werden auf der Grundlage von Änderungen an anderen Eigenschaftenwerten neu berechnet. Um die beste Leistung zu erzielen, sollten Sie vorhandene Werte, die sich nicht geändert haben, nicht einschließen. Die folgenden Eigenschaften können aktualisiert werden.

Eigenschaft	Typ	Beschreibung
bccRecipients	Empfänger	Die Bcc:-Empfänger der Nachricht.
body	ItemBody	Der Nachrichtentext. Nur aktualisierbar, wenn isDraft = true.
categories	String collection	Die Kategorien, die mit der Nachricht verknüpft sind.
ccRecipients	Empfänger-Sammlung	Die Cc:-Empfänger der Nachricht.
Flag	followupFlag	Der Wert des Flags, der den Status, das Startdatum, das Fälligkeitsdatum oder das Enddatum für die Nachricht angibt.
Von	Empfänger	Der Postfachbesitzer und Absender der Nachricht. Muss dem tatsächlich verwendeten Postfach entsprechen.
importance	Zeichenfolge	Die Wichtigkeit der Nachricht. Die möglichen Werte sind: Low, Normal, High.
inferenceClassification	String	Die Klassifizierung der Nachricht für den Benutzer, basierend auf der abgeleiteten Relevanz oder Wichtigkeit oder auf einer expliziten Außerkraftsetzung. Die möglichen Werte sind: focused oder other.
internetMessageId	String	Die Nachrichten-ID in dem von RFC2822 festgelegten Format. Nur aktualisierbar, wenn isDraft = true.
isDeliveryReceiptRequested	Boolean	Zeigt an, ob für die Nachricht eine Lesebestätigung angefordert wird.
isRead	Boolean	Gibt an, ob die Nachricht gelesen wurde.
isReadReceiptRequested	Boolean	Zeigt an, ob für die Nachricht eine Lesebestätigung angefordert wird.
multiValueExtendedProperties	multiValueLegacyExtendedProperty-Sammlung	Die Sammlung von mehrwertigen erweiterten Eigenschaften, die für die Nachricht definiert sind. Nullbar.
replyTo	Empfänger-Sammlung	Die E-Mail-Adressen, die beim Beantworten verwendet werden sollen. Nur aktualisierbar, wenn isDraft = true.
sender	Empfänger	Das Konto, das tatsächlich verwendet wird, um die Nachricht zu generieren. Kann beim Senden einer Nachricht aus einem freigegebenen Postfach oder beim Senden einer Nachricht alsStellvertretung aktualisiert werden. Der Wert muss auf jeden Fall dem tatsächlich verwendeten Postfach entsprechen.
singleValueExtendedProperties	singleValueLegacyExtendedProperty-Sammlung	Die Sammlung der für die Nachricht definierten einwertigen erweiterten Eigenschaften. Nullbar.
subject	String	Der Betreff der Nachricht. Nur aktualisierbar, wenn isDraft = true.
toRecipients	Empfänger-Sammlung	Die An:-Empfänger der Nachricht.

Da die message-Ressource Erweiterungen unterstützt, erlaubt der PATCH-Vorgang das Hinzufügen, Aktualisieren oder Löschen eigener App-spezifischer Daten in den benutzerdefinierten Eigenschaften von Erweiterungen in vorhandenen message-Instanzen.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und das aktualisierte message-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

HTTP

PATCH https://graph.microsoft.com/v1.0/me/messages/{id}
Content-type: application/json

{
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "inferenceClassification": "other"
}

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var message = new Message
{
    Subject = "subject-value",
    Body = new ItemBody
    {
        ContentType = BodyType.Text,
        Content = "content-value"
    },
    InferenceClassification = InferenceClassificationType.Other
};

await graphClient.Me.Messages["{message-id}"]
    .Request()
    .UpdateAsync(message);

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const message = {
  subject: 'subject-value',
  body: {
    contentType: '',
    content: 'content-value'
  },
  inferenceClassification: 'other'
};

await client.api('/me/messages/{id}')
    .update(message);

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

Message message = new Message();
message.subject = "subject-value";
ItemBody body = new ItemBody();
body.contentType = BodyType.TEXT;
body.content = "content-value";
message.body = body;
message.inferenceClassification = InferenceClassificationType.OTHER;

graphClient.me().messages("{id}")
    .buildRequest()
    .patch(message);

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewMessage()
subject := "subject-value"
requestBody.SetSubject(&subject)
body := msgraphsdk.NewItemBody()
requestBody.SetBody(body)
contentType := ""
body.SetContentType(&contentType)
content := "content-value"
body.SetContent(&content)
inferenceClassification := "other"
requestBody.SetInferenceClassification(&inferenceClassification)
messageId := "message-id"
graphClient.Me().MessagesById(&messageId).Patch(requestBody)

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

PowerShell

Import-Module Microsoft.Graph.Mail

$params = @{
    Subject = "subject-value"
    Body = @{
        ContentType = ""
        Content = "content-value"
    }
    InferenceClassification = "other"
}

# A UPN can also be used as -UserId.
Update-MgUserMessage -UserId $userId -MessageId $messageId -BodyParameter $params

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

Hier ist ein Beispiel für die Antwort. Hinweis: Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-type: application/json

{
  "receivedDateTime": "datetime-value",
  "sentDateTime": "datetime-value",
  "hasAttachments": true,
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "bodyPreview": "bodyPreview-value",
  "inferenceClassification": "other"
}

Siehe auch

• Hinzufügen von benutzerdefinierten Daten zu Ressourcen mithilfe von Erweiterungen
• Hinzufügen von benutzerdefinierten Daten zu Benutzern mithilfe offener Erweiterungen (Preview)