Skip to content

Commit 6529a00

Browse files
DanielabomDanielabom
authored
Merge pull request #26671 from microsoftgraph/main
Merge to publish.
2 parents 6455de2 + 7eed33c commit 6529a00

22 files changed

+1018
-25
lines changed

‎api-reference/beta/api/educationassignment-post-resources.md

Lines changed: 149 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -18,13 +18,14 @@ Create an [assignment resource](../resources/educationassignmentresource.md). On
1818

1919
You can create the following types of assignment resources:
2020

21-
- [educationFileResource](../resources/educationfileresource.md)
2221
- [educationExcelResource](../resources/educationexcelresource.md)
23-
- [educationWordResource](../resources/educationwordresource.md)
22+
- [educationFileResource](../resources/educationfileresource.md)
2423
- [educationLinkResource](../resources/educationlinkresource.md)
25-
- [educationPowerPointResource](../resources/educationpowerpointresource.md)
2624
- [educationMediaResource](../resources/educationmediaresource.md)
25+
- [educationPowerPointResource](../resources/educationpowerpointresource.md)
26+
- [educationSpeakerProgressResource](../resources/educationspeakerprogressresource.md)
2727
- [educationTeamsAppResource](../resources/educationteamsappresource.md)
28+
- [educationWordResource](../resources/educationwordresource.md)
2829

2930
Every resource has an **@odata.type** property to indicate which type of resource is being created.
3031

@@ -53,19 +54,32 @@ POST /education/classes/{class-id}/assignments/{assignment-id}/resources
5354
## Request body
5455
In the request body, supply a JSON representation of one of the following resource types:
5556

56-
- [educationFileResource](../resources/educationfileresource.md)
5757
- [educationExcelResource](../resources/educationexcelresource.md)
58-
- [educationWordResource](../resources/educationwordresource.md)
58+
- [educationFileResource](../resources/educationfileresource.md)
5959
- [educationLinkResource](../resources/educationlinkresource.md)
60-
- [educationPowerPointResource](../resources/educationpowerpointresource.md)
6160
- [educationMediaResource](../resources/educationmediaresource.md)
61+
- [educationPowerPointResource](../resources/educationpowerpointresource.md)
62+
- [educationSpeakerProgressResource](../resources/educationspeakerprogressresource.md)
6263
- [educationTeamsAppResource](../resources/educationteamsappresource.md)
64+
- [educationWordResource](../resources/educationwordresource.md)
6365

6466
>**Note:** You can't use this operation to create an [educationExternalResource](../resources/educationexternalresource.md).
6567
6668
## Response
6769
If successful, this method returns a `201 Created` response code and an [educationAssignmentResource](../resources/educationassignmentresource.md) object in the response body.
6870

71+
This method also returns a `400 Bad Request` response code when an invalid request body is provided for the **educationSpeakerProgressResource** assignment resource in the following scenarios:
72+
73+
- The distributable resource attach limit is exceeded.
74+
- No speaker coach setting or AI feedback is enabled.
75+
- AI feedback is enabled, but the AI feedback criteria are null.
76+
- AI feedback is enabled, but no settings are enabled in the AI feedback criteria.
77+
- AI feedback is enabled, but **aiFeedbackCriteria.speechType** has an invalid value.
78+
- AI feedback criteria have settings enabled, but AI feedback isn't enabled.
79+
- **aiFeedbackCriteria.speechType** is set, but AI feedback isn't enabled.
80+
- **recordingTimeLimitInMinutes** isn't between 1 and 10 (inclusive).
81+
- **maxRecordingAttempts** isn't between 0 and 10 (inclusive).
82+
6983
## Examples
7084
### Example 1: Create an educationLinkResource
7185
#### Request
@@ -801,7 +815,136 @@ Content-type: application/json
801815
}
802816
```
803817

818+
### Example 8: Create an educationSpeakerProgressResource
819+
820+
The following example shows how to create an [educationSpeakerProgressResource](../resources/educationspeakerprogressresource.md) assignment resource.
821+
822+
#### Request
823+
824+
The following example shows a request.
825+
826+
<!-- {
827+
"blockType": "request",
828+
"name": "create_educationSpeakerProgressResource"
829+
}
830+
-->
831+
``` http
832+
POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/fe9c8d6f-baad-4b5e-b9d5-e2bb33e4ed19/resources
833+
Content-Type: application/json
834+
835+
{
836+
"distributeForStudentWork": true,
837+
"resource": {
838+
"@odata.type": "microsoft.graph.educationSpeakerProgressResource",
839+
"displayName": "speakerProgressTestResource",
840+
"recordingTimeLimitInMinutes": 5,
841+
"showRehearsalReportToStudentBeforeMediaUpload": true,
842+
"maxRecordingAttempts": 1,
843+
"isVideoRequired": true,
844+
"isAiFeedbackEnabled": true,
845+
"presentationTitle": "speakerProgressTestResource",
846+
"spokenLanguageLocale": "en-US",
847+
"speakerCoachSettings": {
848+
"deliverySettings": {
849+
"isPronunciationEnabled": true
850+
}
851+
},
852+
"aiFeedbackCriteria": {
853+
"speechType": "informative",
854+
"aiFeedbackSettings": {
855+
"deliverySettings": {
856+
"isStyleEnabled": true
857+
}
858+
}
859+
}
860+
}
861+
}
862+
```
863+
864+
#### Response
865+
866+
The following example shows the response.
867+
868+
<!-- {
869+
"blockType": "response",
870+
"truncated": true,
871+
"@odata.type": "microsoft.graph.educationSpeakerProgressResource"
872+
}
873+
-->
874+
``` http
875+
HTTP/1.1 201 Created
876+
Content-Type: application/json
804877
878+
{
879+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments('fe9c8d6f-baad-4b5e-b9d5-e2bb33e4ed19')/resources/$entity",
880+
"distributeForStudentWork": true,
881+
"id": "af98a1e1-3393-4ee0-8bcc-8b5bb4598d1c",
882+
"resource": {
883+
"@odata.type": "#microsoft.graph.educationSpeakerProgressResource",
884+
"displayName": "speakerProgressTestResource",
885+
"createdDateTime": "2025-03-17T16:26:03.5530234Z",
886+
"lastModifiedDateTime": "2025-03-17T16:26:03.5530384Z",
887+
"recordingTimeLimitInMinutes": 5,
888+
"showRehearsalReportToStudentBeforeMediaUpload": true,
889+
"maxRecordingAttempts": 1,
890+
"isVideoRequired": true,
891+
"isAiFeedbackEnabled": true,
892+
"presentationTitle": "speakerProgressTestResource",
893+
"spokenLanguageLocale": "en-US",
894+
"createdBy": {
895+
"application": null,
896+
"device": null,
897+
"user": {
898+
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
899+
"displayName": null
900+
}
901+
},
902+
"lastModifiedBy": {
903+
"application": null,
904+
"device": null,
905+
"user": {
906+
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
907+
"displayName": null
908+
}
909+
},
910+
"speakerCoachSettings": {
911+
"deliverySettings": {
912+
"isPaceEnabled": false,
913+
"areFillerWordsEnabled": false,
914+
"isPitchEnabled": false,
915+
"isPronunciationEnabled": true
916+
},
917+
"contentSettings": {
918+
"isInclusivenessEnabled": false,
919+
"isRepetitiveLanguageEnabled": false
920+
},
921+
"audienceEngagementSettings": {
922+
"isBodyLanguageEnabled": false
923+
}
924+
},
925+
"aiFeedbackCriteria": {
926+
"speechType": "informative",
927+
"aiFeedbackSettings": {
928+
"deliverySettings": {
929+
"isLanguageUseEnabled": false,
930+
"areRhetoricalTechniquesEnabled": false,
931+
"isStyleEnabled": true
932+
},
933+
"contentSettings": {
934+
"isSpeechOrganizationEnabled": false,
935+
"isMessageClarityEnabled": false,
936+
"isQualityOfInformationEnabled": false
937+
},
938+
"audienceEngagementSettings": {
939+
"areEngagementStrategiesEnabled": false,
940+
"isEmotionalAndIntellectualAppealEnabled": false,
941+
"isCallToActionEnabled": false
942+
}
943+
}
944+
}
945+
}
946+
}
947+
```
805948

806949
## Related content
807950

‎api-reference/beta/api/educationassignmentresource-get.md

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -590,6 +590,108 @@ Content-type: application/json
590590
}
591591
```
592592

593+
### Example 7: Get an educationSpeakerProgressResource
594+
595+
The following example shows how to get an [educationSpeakerProgressResource](../resources/educationspeakerprogressresource.md) assignment resource.
596+
597+
#### Request
598+
599+
The following example shows a request.
600+
601+
<!-- {
602+
"blockType": "request",
603+
"name": "specific_educationSpeakerProgressResource"
604+
}
605+
-->
606+
``` http
607+
GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/fe9c8d6f-baad-4b5e-b9d5-e2bb33e4ed19/resources/af98a1e1-3393-4ee0-8bcc-8b5bb4598d1c
608+
```
609+
610+
### Response
611+
612+
The following example shows the response.
613+
>**Note:** The response object shown here might be shortened for readability.
614+
<!-- {
615+
"blockType": "response",
616+
"truncated": true,
617+
"@odata.type": "microsoft.graph.educationSpeakerProgressResource"
618+
}
619+
-->
620+
``` http
621+
HTTP/1.1 200 OK
622+
Content-Type: application/json
623+
624+
{
625+
"@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments('fe9c8d6f-baad-4b5e-b9d5-e2bb33e4ed19')/resources/$entity",
626+
"distributeForStudentWork": true,
627+
"id": "af98a1e1-3393-4ee0-8bcc-8b5bb4598d1c",
628+
"resource": {
629+
"@odata.type": "#microsoft.graph.educationSpeakerProgressResource",
630+
"displayName": "speakerProgressTestResource",
631+
"createdDateTime": "2025-03-17T16:26:03.5530234Z",
632+
"lastModifiedDateTime": "2025-03-17T16:26:03.5530384Z",
633+
"recordingTimeLimitInMinutes": 5,
634+
"showRehearsalReportToStudentBeforeMediaUpload": true,
635+
"maxRecordingAttempts": 1,
636+
"isVideoRequired": true,
637+
"isAiFeedbackEnabled": true,
638+
"presentationTitle": "speakerProgressTestResource",
639+
"spokenLanguageLocale": "en-US",
640+
"createdBy": {
641+
"application": null,
642+
"device": null,
643+
"user": {
644+
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
645+
"displayName": null
646+
}
647+
},
648+
"lastModifiedBy": {
649+
"application": null,
650+
"device": null,
651+
"user": {
652+
"id": "fffafb29-e8bc-4de3-8106-be76ed2ad499",
653+
"displayName": null
654+
}
655+
},
656+
"speakerCoachSettings": {
657+
"deliverySettings": {
658+
"isPaceEnabled": false,
659+
"areFillerWordsEnabled": false,
660+
"isPitchEnabled": false,
661+
"isPronunciationEnabled": true
662+
},
663+
"contentSettings": {
664+
"isInclusivenessEnabled": false,
665+
"isRepetitiveLanguageEnabled": false
666+
},
667+
"audienceEngagementSettings": {
668+
"isBodyLanguageEnabled": false
669+
}
670+
},
671+
"aiFeedbackCriteria": {
672+
"speechType": "informative",
673+
"aiFeedbackSettings": {
674+
"deliverySettings": {
675+
"isLanguageUseEnabled": false,
676+
"areRhetoricalTechniquesEnabled": false,
677+
"isStyleEnabled": true
678+
},
679+
"contentSettings": {
680+
"isSpeechOrganizationEnabled": false,
681+
"isMessageClarityEnabled": false,
682+
"isQualityOfInformationEnabled": false
683+
},
684+
"audienceEngagementSettings": {
685+
"areEngagementStrategiesEnabled": false,
686+
"isEmotionalAndIntellectualAppealEnabled": false,
687+
"isCallToActionEnabled": false
688+
}
689+
}
690+
}
691+
}
692+
}
693+
```
694+
593695
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
594696
2015-10-25 14:57:30 UTC -->
595697
<!--

‎api-reference/beta/resources/educationaifeedbackaudienceengagementsettings.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: "educationAiFeedbackAudienceEngagementSettings resource type"
3+
description: "Represents the audience engagement-related feedback types that students should receive from the AI feedback."
4+
author: "v-rmanda"
5+
ms.date: 03/20/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "education"
8+
doc_type: resourcePageType
9+
toc.title: "Education AI feedback audience engagement settings"
10+
---
11+
12+
# educationAiFeedbackAudienceEngagementSettings resource type
13+
14+
Namespace: microsoft.graph
15+
16+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
17+
18+
Represents the audience engagement-related feedback types that students should receive from the AI feedback.
19+
20+
21+
## Properties
22+
|Property|Type|Description|
23+
|:---|:---|:---|
24+
|areEngagementStrategiesEnabled|Boolean|Indicates whether the student should receive feedback on their engagement strategies from the AI feedback.|
25+
|isCallToActionEnabled|Boolean|Indicates whether the student should receive feedback on their call to action from the AI feedback.|
26+
|isEmotionalAndIntellectualAppealEnabled|Boolean|Indicates whether the student should receive feedback on their emotional and intellectual appeal from the AI feedback.|
27+
28+
## Relationships
29+
None.
30+
31+
## JSON representation
32+
The following JSON representation shows the resource type.
33+
<!-- {
34+
"blockType": "resource",
35+
"@odata.type": "microsoft.graph.educationAiFeedbackAudienceEngagementSettings"
36+
}
37+
-->
38+
``` json
39+
{
40+
"@odata.type": "#microsoft.graph.educationAiFeedbackAudienceEngagementSettings",
41+
"areEngagementStrategiesEnabled": "Boolean",
42+
"isEmotionalAndIntellectualAppealEnabled": "Boolean",
43+
"isCallToActionEnabled": "Boolean"
44+
}
45+
```
46+

‎api-reference/beta/resources/educationaifeedbackcontentsettings.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: "educationAiFeedbackContentSettings resource type"
3+
description: "Represents the content-related feedback types that students should receive from the AI feedback."
4+
author: "v-rmanda"
5+
ms.date: 03/20/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "education"
8+
doc_type: resourcePageType
9+
toc.title: "Education AI feedback content settings"
10+
---
11+
12+
# educationAiFeedbackContentSettings resource type
13+
14+
Namespace: microsoft.graph
15+
16+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
17+
18+
Represents the content-related feedback types that students should receive from the AI feedback.
19+
20+
## Properties
21+
|Property|Type|Description|
22+
|:---|:---|:---|
23+
|isMessageClarityEnabled|Boolean|Indicates whether the student should receive feedback on their message clarity from the AI feedback.|
24+
|isQualityOfInformationEnabled|Boolean|Indicates whether the student should receive feedback on their quality of information from the AI feedback.|
25+
|isSpeechOrganizationEnabled|Boolean|Indicates whether the student should receive feedback on their speech organization from the AI feedback.|
26+
27+
## Relationships
28+
None.
29+
30+
## JSON representation
31+
The following JSON representation shows the resource type.
32+
<!-- {
33+
"blockType": "resource",
34+
"@odata.type": "microsoft.graph.educationAiFeedbackContentSettings"
35+
}
36+
-->
37+
``` json
38+
{
39+
"@odata.type": "#microsoft.graph.educationAiFeedbackContentSettings",
40+
"isMessageClarityEnabled": "Boolean",
41+
"isQualityOfInformationEnabled": "Boolean",
42+
"isSpeechOrganizationEnabled": "Boolean"
43+
}
44+
```
45+

0 commit comments

Comments
 (0)