Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Обновите свойства объекта plannerTaskChatMessage .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба |
Правительство США L4 |
Правительство США L5 (DOD) |
Китай управляется 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения |
Разрешения с наименьшими привилегиями |
Более высокие привилегированные разрешения |
| Делегированные (рабочая или учебная учетная запись) |
Tasks.ReadWrite |
Недоступно. |
| Делегированные (личная учетная запись Майкрософт) |
Не поддерживается. |
Не поддерживается. |
| Для приложений |
Не поддерживается. |
Не поддерживается. |
HTTP-запрос
PATCH /planner/tasks/{task-id}/messages/{message-id}
Текст запроса
В тексте запроса укажите только значения свойств для обновления. Существующие свойства, которые не включены в текст запроса, сохраняют свои предыдущие значения или пересчитываются на основе изменений других значений свойств.
В следующей таблице указаны свойства, которые можно обновить.
| Свойство |
Тип |
Описание |
| content |
String |
Содержимое сообщения чата. Поддерживает обычный текст и дезинфицируемый HTML. |
| mentions |
коллекция plannerTaskChatMention |
Список упоминаний в сообщении. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект plannerTaskChatMessage в тексте отклика.
Этот метод может возвращать любой из кодов состояния HTTP. Наиболее распространенные ошибки, которые приложения должны обрабатывать для этого метода, — это ответы 400, 403, 404 и 409. Дополнительные сведения об этих ошибках см. в разделе Общие условия ошибок Планировщика.
Пример
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/beta/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh/messages/5bde7bc8-d998-4e8a-8159-93d4d7ccc3b5
Content-type: application/json
{
"content": "<div>Updated message with <span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> mention</div>",
"mentions": [
{
"mentioned": "6463a5ce-2119-4198-9f2a-628761df4a62",
"position": 0,
"mentionType": "user"
}
]
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new PlannerTaskChatMessage
{
Content = "<div>Updated message with <span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> mention</div>",
Mentions = new List<PlannerTaskChatMention>
{
new PlannerTaskChatMention
{
Mentioned = "6463a5ce-2119-4198-9f2a-628761df4a62",
Position = 0,
MentionType = PlannerTaskChatMentionType.User,
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Planner.Tasks["{plannerTask-id}"].Messages["{plannerTaskChatMessage-id}"].PatchAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewPlannerTaskChatMessage()
content := "<div>Updated message with <span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> mention</div>"
requestBody.SetContent(&content)
plannerTaskChatMention := graphmodels.NewPlannerTaskChatMention()
mentioned := "6463a5ce-2119-4198-9f2a-628761df4a62"
plannerTaskChatMention.SetMentioned(&mentioned)
position := int32(0)
plannerTaskChatMention.SetPosition(&position)
mentionType := graphmodels.USER_PLANNERTASKCHATMENTIONTYPE
plannerTaskChatMention.SetMentionType(&mentionType)
mentions := []graphmodels.PlannerTaskChatMentionable {
plannerTaskChatMention,
}
requestBody.SetMentions(mentions)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
messages, err := graphClient.Planner().Tasks().ByPlannerTaskId("plannerTask-id").Messages().ByPlannerTaskChatMessageId("plannerTaskChatMessage-id").Patch(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
PlannerTaskChatMessage plannerTaskChatMessage = new PlannerTaskChatMessage();
plannerTaskChatMessage.setContent("<div>Updated message with <span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> mention</div>");
LinkedList<PlannerTaskChatMention> mentions = new LinkedList<PlannerTaskChatMention>();
PlannerTaskChatMention plannerTaskChatMention = new PlannerTaskChatMention();
plannerTaskChatMention.setMentioned("6463a5ce-2119-4198-9f2a-628761df4a62");
plannerTaskChatMention.setPosition(0);
plannerTaskChatMention.setMentionType(PlannerTaskChatMentionType.User);
mentions.add(plannerTaskChatMention);
plannerTaskChatMessage.setMentions(mentions);
PlannerTaskChatMessage result = graphClient.planner().tasks().byPlannerTaskId("{plannerTask-id}").messages().byPlannerTaskChatMessageId("{plannerTaskChatMessage-id}").patch(plannerTaskChatMessage);
const options = {
authProvider,
};
const client = Client.init(options);
const plannerTaskChatMessage = {
content: '<div>Updated message with <span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> mention</div>',
mentions: [
{
mentioned: '6463a5ce-2119-4198-9f2a-628761df4a62',
position: 0,
mentionType: 'user'
}
]
};
await client.api('/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh/messages/5bde7bc8-d998-4e8a-8159-93d4d7ccc3b5')
.version('beta')
.update(plannerTaskChatMessage);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\PlannerTaskChatMessage;
use Microsoft\Graph\Beta\Generated\Models\PlannerTaskChatMention;
use Microsoft\Graph\Beta\Generated\Models\PlannerTaskChatMentionType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new PlannerTaskChatMessage();
$requestBody->setContent('<div>Updated message with <span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> mention</div>');
$mentionsPlannerTaskChatMention1 = new PlannerTaskChatMention();
$mentionsPlannerTaskChatMention1->setMentioned('6463a5ce-2119-4198-9f2a-628761df4a62');
$mentionsPlannerTaskChatMention1->setPosition(0);
$mentionsPlannerTaskChatMention1->setMentionType(new PlannerTaskChatMentionType('user'));
$mentionsArray []= $mentionsPlannerTaskChatMention1;
$requestBody->setMentions($mentionsArray);
$result = $graphServiceClient->planner()->tasks()->byPlannerTaskId('plannerTask-id')->messages()->byPlannerTaskChatMessageId('plannerTaskChatMessage-id')->patch($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Planner
$params = @{
content = "<div>Updated message with <span itemid="0" itemtype="https://schema.skype.com/Mention/Person"></span> mention</div>"
mentions = @(
@{
mentioned = "6463a5ce-2119-4198-9f2a-628761df4a62"
position = 0
mentionType = "user"
}
)
}
Update-MgBetaPlannerTaskMessage -PlannerTaskId $plannerTaskId -PlannerTaskChatMessageId $plannerTaskChatMessageId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.planner_task_chat_message import PlannerTaskChatMessage
from msgraph_beta.generated.models.planner_task_chat_mention import PlannerTaskChatMention
from msgraph_beta.generated.models.planner_task_chat_mention_type import PlannerTaskChatMentionType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = PlannerTaskChatMessage(
content = "<div>Updated message with <span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> mention</div>",
mentions = [
PlannerTaskChatMention(
mentioned = "6463a5ce-2119-4198-9f2a-628761df4a62",
position = 0,
mention_type = PlannerTaskChatMentionType.User,
),
],
)
result = await graph_client.planner.tasks.by_planner_task_id('plannerTask-id').messages.by_planner_task_chat_message_id('plannerTaskChatMessage-id').patch(request_body)
Отклик
Ниже приводится пример отклика.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#planner/tasks('01gzSlKkIUSUl6DF_EilrmQAKDhh')/messages/$entity",
"id": "5bde7bc8-d998-4e8a-8159-93d4d7ccc3b5",
"messageType": "richTextHtml",
"content": "<div>Updated message with <span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> mention</div>",
"createdDateTime": "2025-12-05T17:49:39.593Z",
"parentEntityId": "01gzSlKkIUSUl6DF_EilrmQAKDhh",
"deletedTime": null,
"editedTime": "2025-12-05T18:15:24.706Z",
"mentions": [
{
"mentioned": "6463a5ce-2119-4198-9f2a-628761df4a62",
"position": 0,
"mentionType": "user"
}
],
"reactions": [],
"createdBy": {
"user": {
"id": "6463a5ce-2119-4198-9f2a-628761df4a62"
}
}
}