Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
No corpo da solicitação, forneça apenas os valores dos campos que você deseja atualizar.
Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.
O objeto educationOutcome será um dos seguintes tipos derivados: educationPointsOutcome, educationFeedbackOutcome ou educationRubricOutcome. Forneça as propriedades específicas relevantes para o tipo de resultado que você está atualizando.
Todos os tipos de resultado derivados têm uma propriedade regular e "publicada" apropriada para esse tipo de resultado; por exemplo, pontos e publicadosPoints, comentários e publicadosFeedback. Não atualize a propriedade "publicado"; é para uso interno. Por exemplo, para atribuir pontos a um educationPointsOutcome, atualize a propriedade de pontos , mas não atualize publishedPoints.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK código de resposta e um objeto educationOutcome atualizado no corpo da resposta.
Se pontosGradeType e pontos forem atualizados para um valor negativo ou infinito, o método retornará uma mensagem de 400 erro.
HTTP/1.1 400 Bad Request
Content-type: application/json
{
"error": {
"code": "badRequest",
"message": "Bad request.",
"innerError": {
"code": "invalidGrading",
"message": "Points must be less than 9999999 when using PointsGradeType."
}
}
}
Se uma ID de resultado inválida for especificada, um 404 Not Found erro será retornado.
HTTP/1.1 404 Not Found
Content-type: application/json
{
"error": {
"code": "20241",
"message": "Entity not found. Outcome id: 05d0f76c-1dfa-4442-926c-1b094828b505"
}
}
Exemplos
Exemplo 1: atualizar um resultado de comentários
Solicitação
O exemplo a seguir mostra uma solicitação para atualizar um resultado de comentários.
PATCH https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/submissions/d1bee293-d8bb-48d4-af3e-c8cb0e3c7fe7/outcomes/9c0f2850-ff8f-4fd6-b3ac-e23077b59141
Content-type: application/json
{
"@odata.type":"#microsoft.graph.educationFeedbackOutcome",
"feedback":{
"text":{
"content":"This is feedback for the assignment as a whole.",
"contentType":"text"
}
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new EducationFeedbackOutcome
{
OdataType = "#microsoft.graph.educationFeedbackOutcome",
Feedback = new EducationFeedback
{
Text = new EducationItemBody
{
Content = "This is feedback for the assignment as a whole.",
ContentType = BodyType.Text,
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Education.Classes["{educationClass-id}"].Assignments["{educationAssignment-id}"].Submissions["{educationSubmission-id}"].Outcomes["{educationOutcome-id}"].PatchAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc education classes assignments submissions outcomes patch --education-class-id {educationClass-id} --education-assignment-id {educationAssignment-id} --education-submission-id {educationSubmission-id} --education-outcome-id {educationOutcome-id} --body '{\
"@odata.type":"#microsoft.graph.educationFeedbackOutcome",\
"feedback":{\
"text":{\
"content":"This is feedback for the assignment as a whole.",\
"contentType":"text"\
}\
}\
}\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
EducationFeedbackOutcome educationOutcome = new EducationFeedbackOutcome();
educationOutcome.setOdataType("#microsoft.graph.educationFeedbackOutcome");
EducationFeedback feedback = new EducationFeedback();
EducationItemBody text = new EducationItemBody();
text.setContent("This is feedback for the assignment as a whole.");
text.setContentType(BodyType.Text);
feedback.setText(text);
educationOutcome.setFeedback(feedback);
EducationOutcome result = graphClient.education().classes().byEducationClassId("{educationClass-id}").assignments().byEducationAssignmentId("{educationAssignment-id}").submissions().byEducationSubmissionId("{educationSubmission-id}").outcomes().byEducationOutcomeId("{educationOutcome-id}").patch(educationOutcome);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EducationFeedbackOutcome;
use Microsoft\Graph\Generated\Models\EducationFeedback;
use Microsoft\Graph\Generated\Models\EducationItemBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EducationFeedbackOutcome();
$requestBody->setOdataType('#microsoft.graph.educationFeedbackOutcome');
$feedback = new EducationFeedback();
$feedbackText = new EducationItemBody();
$feedbackText->setContent('This is feedback for the assignment as a whole.');
$feedbackText->setContentType(new BodyType('text'));
$feedback->setText($feedbackText);
$requestBody->setFeedback($feedback);
$result = $graphServiceClient->education()->classes()->byEducationClassId('educationClass-id')->assignments()->byEducationAssignmentId('educationAssignment-id')->submissions()->byEducationSubmissionId('educationSubmission-id')->outcomes()->byEducationOutcomeId('educationOutcome-id')->patch($requestBody)->wait();
from msgraph import GraphServiceClient
from msgraph.generated.models.education_feedback_outcome import EducationFeedbackOutcome
from msgraph.generated.models.education_feedback import EducationFeedback
from msgraph.generated.models.education_item_body import EducationItemBody
graph_client = GraphServiceClient(credentials, scopes)
request_body = EducationFeedbackOutcome(
odata_type = "#microsoft.graph.educationFeedbackOutcome",
feedback = EducationFeedback(
text = EducationItemBody(
content = "This is feedback for the assignment as a whole.",
content_type = BodyType.Text,
),
),
)
result = await graph_client.education.classes.by_education_class_id('educationClass-id').assignments.by_education_assignment_id('educationAssignment-id').submissions.by_education_submission_id('educationSubmission-id').outcomes.by_education_outcome_id('educationOutcome-id').patch(request_body)
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new EducationPointsOutcome
{
OdataType = "#microsoft.graph.educationPointsOutcome",
Points = new EducationAssignmentPointsGrade
{
OdataType = "#microsoft.graph.educationAssignmentPointsGrade",
Points = 85.0f,
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Education.Classes["{educationClass-id}"].Assignments["{educationAssignment-id}"].Submissions["{educationSubmission-id}"].Outcomes["{educationOutcome-id}"].PatchAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
EducationPointsOutcome educationOutcome = new EducationPointsOutcome();
educationOutcome.setOdataType("#microsoft.graph.educationPointsOutcome");
EducationAssignmentPointsGrade points = new EducationAssignmentPointsGrade();
points.setOdataType("#microsoft.graph.educationAssignmentPointsGrade");
points.setPoints(85.0f);
educationOutcome.setPoints(points);
EducationOutcome result = graphClient.education().classes().byEducationClassId("{educationClass-id}").assignments().byEducationAssignmentId("{educationAssignment-id}").submissions().byEducationSubmissionId("{educationSubmission-id}").outcomes().byEducationOutcomeId("{educationOutcome-id}").patch(educationOutcome);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EducationPointsOutcome;
use Microsoft\Graph\Generated\Models\EducationAssignmentPointsGrade;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EducationPointsOutcome();
$requestBody->setOdataType('#microsoft.graph.educationPointsOutcome');
$points = new EducationAssignmentPointsGrade();
$points->setOdataType('#microsoft.graph.educationAssignmentPointsGrade');
$points->setPoints(85.0);
$requestBody->setPoints($points);
$result = $graphServiceClient->education()->classes()->byEducationClassId('educationClass-id')->assignments()->byEducationAssignmentId('educationAssignment-id')->submissions()->byEducationSubmissionId('educationSubmission-id')->outcomes()->byEducationOutcomeId('educationOutcome-id')->patch($requestBody)->wait();
PATCH https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/submissions/d1bee293-d8bb-48d4-af3e-c8cb0e3c7fe7/outcomes/9c0f2850-ff8f-4fd6-b3ac-e23077b59141
Content-type: application/json
{
"@odata.type":"#microsoft.graph.educationRubricOutcome",
"rubricQualityFeedback":[
{
"qualityId":"9a145aa8-f3d9-43a1-8f77-5387ff0693f2",
"feedback":{
"content":"This is feedback specific to the first quality of the rubric.",
"contentType":"text"
}
},
{
"qualityId":"d2331fb2-2761-402e-8de6-93e0afaa076e",
"feedback":{
"content":"This is feedback specific to the second quality of the rubric.",
"contentType":"text"
}
}
],
"rubricQualitySelectedLevels":[
{
"qualityId":"9a145aa8-f3d9-43a1-8f77-5387ff0693f2",
"columnId":"4fb17a1d-5681-46c2-a295-4e305c3eae23"
},
{
"qualityId":"d2331fb2-2761-402e-8de6-93e0afaa076e",
"columnId":"aac076bf-51ba-48c5-a2e0-ee235b0b9740"
}
]
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new EducationRubricOutcome
{
OdataType = "#microsoft.graph.educationRubricOutcome",
RubricQualityFeedback = new List<RubricQualityFeedbackModel>
{
new RubricQualityFeedbackModel
{
QualityId = "9a145aa8-f3d9-43a1-8f77-5387ff0693f2",
Feedback = new EducationItemBody
{
Content = "This is feedback specific to the first quality of the rubric.",
ContentType = BodyType.Text,
},
},
new RubricQualityFeedbackModel
{
QualityId = "d2331fb2-2761-402e-8de6-93e0afaa076e",
Feedback = new EducationItemBody
{
Content = "This is feedback specific to the second quality of the rubric.",
ContentType = BodyType.Text,
},
},
},
RubricQualitySelectedLevels = new List<RubricQualitySelectedColumnModel>
{
new RubricQualitySelectedColumnModel
{
QualityId = "9a145aa8-f3d9-43a1-8f77-5387ff0693f2",
ColumnId = "4fb17a1d-5681-46c2-a295-4e305c3eae23",
},
new RubricQualitySelectedColumnModel
{
QualityId = "d2331fb2-2761-402e-8de6-93e0afaa076e",
ColumnId = "aac076bf-51ba-48c5-a2e0-ee235b0b9740",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Education.Classes["{educationClass-id}"].Assignments["{educationAssignment-id}"].Submissions["{educationSubmission-id}"].Outcomes["{educationOutcome-id}"].PatchAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc education classes assignments submissions outcomes patch --education-class-id {educationClass-id} --education-assignment-id {educationAssignment-id} --education-submission-id {educationSubmission-id} --education-outcome-id {educationOutcome-id} --body '{\
"@odata.type":"#microsoft.graph.educationRubricOutcome",\
"rubricQualityFeedback":[\
{\
"qualityId":"9a145aa8-f3d9-43a1-8f77-5387ff0693f2",\
"feedback":{\
"content":"This is feedback specific to the first quality of the rubric.",\
"contentType":"text"\
}\
},\
{\
"qualityId":"d2331fb2-2761-402e-8de6-93e0afaa076e",\
"feedback":{\
"content":"This is feedback specific to the second quality of the rubric.",\
"contentType":"text"\
}\
}\
],\
"rubricQualitySelectedLevels":[\
{\
"qualityId":"9a145aa8-f3d9-43a1-8f77-5387ff0693f2",\
"columnId":"4fb17a1d-5681-46c2-a295-4e305c3eae23"\
},\
{\
"qualityId":"d2331fb2-2761-402e-8de6-93e0afaa076e",\
"columnId":"aac076bf-51ba-48c5-a2e0-ee235b0b9740"\
}\
]\
}\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
EducationRubricOutcome educationOutcome = new EducationRubricOutcome();
educationOutcome.setOdataType("#microsoft.graph.educationRubricOutcome");
LinkedList<RubricQualityFeedbackModel> rubricQualityFeedback = new LinkedList<RubricQualityFeedbackModel>();
RubricQualityFeedbackModel rubricQualityFeedbackModel = new RubricQualityFeedbackModel();
rubricQualityFeedbackModel.setQualityId("9a145aa8-f3d9-43a1-8f77-5387ff0693f2");
EducationItemBody feedback = new EducationItemBody();
feedback.setContent("This is feedback specific to the first quality of the rubric.");
feedback.setContentType(BodyType.Text);
rubricQualityFeedbackModel.setFeedback(feedback);
rubricQualityFeedback.add(rubricQualityFeedbackModel);
RubricQualityFeedbackModel rubricQualityFeedbackModel1 = new RubricQualityFeedbackModel();
rubricQualityFeedbackModel1.setQualityId("d2331fb2-2761-402e-8de6-93e0afaa076e");
EducationItemBody feedback1 = new EducationItemBody();
feedback1.setContent("This is feedback specific to the second quality of the rubric.");
feedback1.setContentType(BodyType.Text);
rubricQualityFeedbackModel1.setFeedback(feedback1);
rubricQualityFeedback.add(rubricQualityFeedbackModel1);
educationOutcome.setRubricQualityFeedback(rubricQualityFeedback);
LinkedList<RubricQualitySelectedColumnModel> rubricQualitySelectedLevels = new LinkedList<RubricQualitySelectedColumnModel>();
RubricQualitySelectedColumnModel rubricQualitySelectedColumnModel = new RubricQualitySelectedColumnModel();
rubricQualitySelectedColumnModel.setQualityId("9a145aa8-f3d9-43a1-8f77-5387ff0693f2");
rubricQualitySelectedColumnModel.setColumnId("4fb17a1d-5681-46c2-a295-4e305c3eae23");
rubricQualitySelectedLevels.add(rubricQualitySelectedColumnModel);
RubricQualitySelectedColumnModel rubricQualitySelectedColumnModel1 = new RubricQualitySelectedColumnModel();
rubricQualitySelectedColumnModel1.setQualityId("d2331fb2-2761-402e-8de6-93e0afaa076e");
rubricQualitySelectedColumnModel1.setColumnId("aac076bf-51ba-48c5-a2e0-ee235b0b9740");
rubricQualitySelectedLevels.add(rubricQualitySelectedColumnModel1);
educationOutcome.setRubricQualitySelectedLevels(rubricQualitySelectedLevels);
EducationOutcome result = graphClient.education().classes().byEducationClassId("{educationClass-id}").assignments().byEducationAssignmentId("{educationAssignment-id}").submissions().byEducationSubmissionId("{educationSubmission-id}").outcomes().byEducationOutcomeId("{educationOutcome-id}").patch(educationOutcome);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EducationRubricOutcome;
use Microsoft\Graph\Generated\Models\RubricQualityFeedbackModel;
use Microsoft\Graph\Generated\Models\EducationItemBody;
use Microsoft\Graph\Generated\Models\RubricQualitySelectedColumnModel;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EducationRubricOutcome();
$requestBody->setOdataType('#microsoft.graph.educationRubricOutcome');
$rubricQualityFeedbackRubricQualityFeedbackModel1 = new RubricQualityFeedbackModel();
$rubricQualityFeedbackRubricQualityFeedbackModel1->setQualityId('9a145aa8-f3d9-43a1-8f77-5387ff0693f2');
$rubricQualityFeedbackRubricQualityFeedbackModel1Feedback = new EducationItemBody();
$rubricQualityFeedbackRubricQualityFeedbackModel1Feedback->setContent('This is feedback specific to the first quality of the rubric.');
$rubricQualityFeedbackRubricQualityFeedbackModel1Feedback->setContentType(new BodyType('text'));
$rubricQualityFeedbackRubricQualityFeedbackModel1->setFeedback($rubricQualityFeedbackRubricQualityFeedbackModel1Feedback);
$rubricQualityFeedbackArray []= $rubricQualityFeedbackRubricQualityFeedbackModel1;
$rubricQualityFeedbackRubricQualityFeedbackModel2 = new RubricQualityFeedbackModel();
$rubricQualityFeedbackRubricQualityFeedbackModel2->setQualityId('d2331fb2-2761-402e-8de6-93e0afaa076e');
$rubricQualityFeedbackRubricQualityFeedbackModel2Feedback = new EducationItemBody();
$rubricQualityFeedbackRubricQualityFeedbackModel2Feedback->setContent('This is feedback specific to the second quality of the rubric.');
$rubricQualityFeedbackRubricQualityFeedbackModel2Feedback->setContentType(new BodyType('text'));
$rubricQualityFeedbackRubricQualityFeedbackModel2->setFeedback($rubricQualityFeedbackRubricQualityFeedbackModel2Feedback);
$rubricQualityFeedbackArray []= $rubricQualityFeedbackRubricQualityFeedbackModel2;
$requestBody->setRubricQualityFeedback($rubricQualityFeedbackArray);
$rubricQualitySelectedLevelsRubricQualitySelectedColumnModel1 = new RubricQualitySelectedColumnModel();
$rubricQualitySelectedLevelsRubricQualitySelectedColumnModel1->setQualityId('9a145aa8-f3d9-43a1-8f77-5387ff0693f2');
$rubricQualitySelectedLevelsRubricQualitySelectedColumnModel1->setColumnId('4fb17a1d-5681-46c2-a295-4e305c3eae23');
$rubricQualitySelectedLevelsArray []= $rubricQualitySelectedLevelsRubricQualitySelectedColumnModel1;
$rubricQualitySelectedLevelsRubricQualitySelectedColumnModel2 = new RubricQualitySelectedColumnModel();
$rubricQualitySelectedLevelsRubricQualitySelectedColumnModel2->setQualityId('d2331fb2-2761-402e-8de6-93e0afaa076e');
$rubricQualitySelectedLevelsRubricQualitySelectedColumnModel2->setColumnId('aac076bf-51ba-48c5-a2e0-ee235b0b9740');
$rubricQualitySelectedLevelsArray []= $rubricQualitySelectedLevelsRubricQualitySelectedColumnModel2;
$requestBody->setRubricQualitySelectedLevels($rubricQualitySelectedLevelsArray);
$result = $graphServiceClient->education()->classes()->byEducationClassId('educationClass-id')->assignments()->byEducationAssignmentId('educationAssignment-id')->submissions()->byEducationSubmissionId('educationSubmission-id')->outcomes()->byEducationOutcomeId('educationOutcome-id')->patch($requestBody)->wait();
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.type": "#microsoft.graph.educationRubricOutcome",
"id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b",
"rubricQualityFeedback": [
{
"qualityId": "9a145aa8-f3d9-43a1-8f77-5387ff0693f2",
"feedback": {
"content": "This is feedback specific to the first quality of the rubric.",
"contentType": "text"
}
},
{
"qualityId": "d2331fb2-2761-402e-8de6-93e0afaa076e",
"feedback": {
"content": "This is feedback specific to the second quality of the rubric.",
"contentType": "text"
}
}
],
"rubricQualitySelectedLevels": [
{
"qualityId": "9a145aa8-f3d9-43a1-8f77-5387ff0693f2",
"columnId": "4fb17a1d-5681-46c2-a295-4e305c3eae23"
},
{
"qualityId": "d2331fb2-2761-402e-8de6-93e0afaa076e",
"columnId": "aac076bf-51ba-48c5-a2e0-ee235b0b9740"
}
]
}
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.