educationAssignment: setUpResourcesFolder
Espacio de nombres: microsoft.graph
Cree una carpeta de SharePoint para cargar archivos para un determinado educationAssignment. Solo los profesores pueden realizar esta operación.
El profesor determina los recursos que se van a cargar en la carpeta de la asignación.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
---|---|---|
Delegado (cuenta profesional o educativa) | EduAssignments.ReadWrite | No disponible. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | EduAssignments.ReadWrite.All | No disponible. |
Solicitud HTTP
POST /education/classes/{id}/assignments/{id}/setUpResourcesFolder
Encabezados de solicitud
Encabezado | Valor |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione un objeto {}
JSON vacío para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y un objeto educationAssignment en el cuerpo de la solicitud.
Si la asignación especificada ya tiene una carpeta, este método devuelve y 400 Bad request
una respuesta de error.
Ejemplo
En el siguiente ejemplo se muestra cómo llamar a esta API.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/education/classes/955e0bd5-52c2-41ad-b7e8-5b33a18c5e78/assignments/18d17255-3278-49fb-8da7-d095b7f610c4/setUpResourcesFolder
Content-type: application/json
{
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#education/classes('955e0bd5-52c2-41ad-b7e8-5b33a18c5e78')/assignments/$entity",
"classId": "955e0bd5-52c2-41ad-b7e8-5b33a18c5e78",
"displayName": "Unit 3 Essay",
"closeDateTime": "2021-04-06T00:00:00Z",
"dueDateTime": "2021-04-05T00:00:00Z",
"assignDateTime": "2021-04-01T00:00:00Z",
"assignedDateTime": null,
"allowLateSubmissions": true,
"createdDateTime": "2021-03-04T00:02:31.9834674Z",
"lastModifiedDateTime": "2021-03-04T00:02:32.0954032Z",
"allowStudentsToAddResourcesToSubmission": true,
"status": "draft",
"notificationChannelUrl": null,
"addedStudentAction": "assignIfOpen",
"addToCalendarAction": "studentsAndTeamOwners",
"id": "18d17255-3278-49fb-8da7-d095b7f610c4",
"instructions": {
"content": "Upload a 500 word essay about the theme of nature in a Shakespearean sonnet.",
"contentType": "text"
},
"grading": {
"@odata.type": "#microsoft.graph.educationAssignmentPointsGradeType",
"maxPoints": 100
},
"assignTo": {
"@odata.type": "#microsoft.graph.educationAssignmentIndividualRecipient",
"recipients": [
"42ff222c-571f-497c-a9d3-f77ea9ece327"
]
},
"resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!H0Unq6KJREmMLHgbJXfKw4YTuh2luKRDvUVGQBLOmvaRxxvbedZKT4LKslSIjT9a/items/01SMYGQ3IUCDNLBJ4XCFE3AQMQHTLSLVYX",
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "42ff222c-571f-497c-a9d3-f77ea9ece327",
"displayName": null
}
},
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "42ff222c-571f-497c-a9d3-f77ea9ece327",
"displayName": null
}
}
}
Si la asignación especificada ya tiene una carpeta, este método devuelve y 400 Bad request
una respuesta de error.
HTTP/1.1 400 Bad request
Content-type: application/json
{
"error": {
"code": "badRequest",
"message": "Bad request.",
"innerError": {
"code": "folderAlreadyExists",
"message": "Resource folder already exists and has previously been set up.",
"date": "2021-09-14T19:05:24",
"request-id": "f88be238-1339-49c8-b03d-37f45d54761f",
"client-request-id": "30d8081a-f3e8-73e0-2da4-3480fb56ccdb"
}
}
}