tipo de recurso educationAssignment
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa una tarea o unidad de trabajo asignada a un alumno o miembro del equipo en una clase como parte del estudio.
Las asignaciones contienen documentos y tareas en las que el maestro quiere que el alumno trabaje. Cada asignación de alumno tiene un envío asociado que contiene cualquier trabajo que se le pida a su maestro que se le entregara. Solo los profesores o los propietarios del equipo pueden crear asignaciones. Un profesor puede agregar puntuaciones y comentarios al envío enviado por el alumno.
Cuando se crea una asignación , se encuentra en un estado de borrador. Los alumnos no pueden ver la asignación y los envíos no se crean. Puede cambiar el estado de una asignación mediante la acción de publicación . No se puede usar una solicitud PATCH para cambiar el estado de la asignación .
Las API de asignación se exponen en el espacio de nombres de clase.
Hereda de la entidad.
Methods
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Crear recursos de la tarea | educationAssignmentResource | Cree un nuevo educationAssignmentResource publicando en la colección resources. |
| Obtener la tarea | educationAssignment | Lee las propiedades y las relaciones de un objeto educationAssignment . |
| Actualizar | educationAssignment | Actualice un objeto educationAssignment . |
| Delete | Ninguno | Elimine un objeto educationAssignment . |
| Publicar | educationAssignment | Cambie el estado de un objeto educationAssignment de borrador a publicado. |
| Configurar la carpeta de recursos de asignación | string | Cree una carpeta de SharePoint (en una ubicación predefinida) para cargar archivos como recursos de asignación. |
| Configurar la carpeta de recursos de comentarios de asignación | educationAssignment | Cree una carpeta de SharePoint para cargar los archivos de comentarios para un determinado educationSubmission. |
| Enumerar recursos | educationAssignmentResource (colección) | Obtenga una colección de objetos educationAssignmentResource . |
| Envíos de lista | colección educationSubmission | Obtenga una colección de objetos educationSubmission . |
| Enumerar categorías | colección educationCategory | Obtenga una colección de objetos educationCategory . |
| Agregar categorías | educationCategory | Asigne una educationCategory que pertenezca a la clase a esta asignación. |
| Quitar categoría | Ninguno | Quite una educationCategory que pertenece a la clase de esta asignación. |
| Adjuntar rúbrica | Ninguno | Adjunte un elemento educationRubric existente a esta asignación. |
| Eliminación de la rúbrica | Ninguno | Desasocie educationRubric de esta asignación. |
| Obtener delta | colección educationAssignment | Obtenga una lista de las asignaciones recién creadas o actualizadas sin tener que realizar una lectura completa de la colección. |
| Agregar educationGradingCategory | educationGradingCategory | Agregue gradingCategory publicando en la colección gradingCategory. |
| Eliminación de educationGradingCategory | Ninguno | Quite un objeto educationGradingCategory . |
| Activar asignación | educationAssignment | Activar una instrucción inactivaAsignación para indicar que la asignación tiene elementos de acción adicionales para profesores o alumnos. |
| Desactivar asignación | educationAssignment | Marque un elemento educationAssignment asignado como inactivo para indicar que la asignación no tiene elementos de acción adicionales para los profesores y los alumnos. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| addedStudentAction | Cadena | Campo opcional para controlar el comportamiento de la asignación de los alumnos que se agregan después de publicar la asignación . Si no se especifica, el valor predeterminado es none. Los valores admitidos son: none, assignIfOpen. Por ejemplo, un profesor puede usar assignIfOpen para indicar que se debe asignar una asignación a cualquier nuevo alumno que se una a la clase mientras la asignación sigue abierta y none para indicar que no se debe asignar una asignación a nuevos alumnos. |
| addToCalendarAction | educationAddToCalendarOptions | Campo opcional para controlar el comportamiento de la asignación para agregar asignaciones a los calendarios de alumnos y profesores cuando se publica la asignación . Los valores posibles son: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValuey studentsOnly. Debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores en esta enumeración evolvable: studentsOnly. El valor predeterminado es none. |
| allowLateSubmissions | Booleano | Identifica si los alumnos pueden enviar después de la fecha de vencimiento. Si esta propiedad no se especifica durante la creación, el valor predeterminado es true. |
| allowStudentsToAddResourcesToSubmission | Booleano | Identifica si los alumnos pueden agregar sus propios recursos a un envío o si solo pueden modificar los recursos agregados por el profesor. |
| assignDateTime | DateTimeOffset | Fecha en la que la asignación debe activarse. Si en el futuro, la asignación no se muestra al alumno hasta esta fecha. El tipo Timestamp representa la información de fecha y hora con el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| assignTo | educationAssignmentRecipient | Qué usuarios o clase completa deben recibir un objeto de envío una vez publicada la asignación . |
| assignedDateTime | DateTimeOffset | El momento en que la asignación se publicó a los alumnos y la asignación aparece en la escala de tiempo de los alumnos. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| classId | Cadena | Clase a la que pertenece esta asignación . |
| closeDateTime | DateTimeOffset | Fecha en la que se cerrará la asignación para envíos. Se trata de un campo opcional que puede ser null si la asignación no permiteLateSubmissions o cuando closeDateTime es el mismo que dueDateTime. Pero si se especifica, closeDateTime debe ser mayor o igual que dueDateTime. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| createdBy | identitySet | Quién creó la asignación. |
| createdDateTime | DateTimeOffset | Momento en que se creó la asignación . El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| displayName | Cadena | Nombre de la asignación. |
| dueDateTime | DateTimeOffset | Fecha de vencimiento de la asignación de los alumnos. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| feedbackResourcesFolderUrl | Cadena | Dirección URL de carpeta donde se almacenan todos los recursos del archivo de comentarios para esta asignación . |
| Clasificación | educationAssignmentGradeType | Cómo se calificará la asignación . |
| id | Cadena | Identificador único de la asignación. Heredado de la entidad. Solo lectura. |
| Instrucciones | itemBody | Instrucciones para la asignación. Esta propiedad y el nombre para mostrar indican al alumno qué hacer. |
| lastModifiedBy | identitySet | Quién modificó por última vez la asignación. |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora en que se modificó la asignación . Un envío de alumno no modifica la asignación; solo los profesores pueden actualizar las asignaciones. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| moduleUrl | string | Dirección URL del módulo desde el que se va a acceder a la asignación. |
| notificationChannelUrl | Cadena | Campo opcional para especificar la dirección URL del canal para publicar la notificación de publicación de asignación . Si no se especifica o es NULL, el valor predeterminado es el General canal. Este campo solo se aplica a las asignaciones donde el valor assignTo es educationAssignmentClassRecipient. No se permite actualizar notificationChannelUrl una vez publicada la asignación . |
| resourcesFolderUrl | string | Dirección URL de carpeta donde se almacenan todos los recursos de archivo para esta asignación . |
| status | cadena | Estado de la asignación. No se puede aplicar patch a este valor. Los valores posibles son: draft, scheduled, published, assigned, unknownFutureValue, inactive. Debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores en esta enumeración evolvable: inactive. |
| webUrl | string | Dirección URL del vínculo profundo de la asignación especificada. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| recursos | educationAssignmentResource (colección) | Objetos de aprendizaje asociados a esta asignación. Solo los profesores pueden modificar esta lista. Admite valores NULL. |
| Presentaciones | colección educationSubmission | Una vez publicado, hay un objeto de envío para cada alumno que representa su trabajo y calificación. Solo lectura. Admite valores NULL. |
| categories | colección educationCategory | Cuando se establece, permite a los usuarios encontrar fácilmente las asignaciones de un tipo determinado. Solo lectura. Admite valores NULL. |
| Rúbrica | educationRubric | Cuando se establece, la rúbrica de calificación adjunta a esta asignación. |
| gradingCategory | educationGradingCategory (colección) | Cuando se establece, permite a los usuarios ponderar las asignaciones de forma diferente al calcular una calificación media de clase. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"addedStudentAction": "String",
"addToCalendarAction": "String",
"allowLateSubmissions": "Boolean",
"allowStudentsToAddResourcesToSubmission": "Boolean",
"assignDateTime": "String (timestamp)",
"assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
"assignedDateTime": "String (timestamp)",
"classId": "String",
"closeDateTime": "String (timestamp)",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"displayName": "String",
"dueDateTime": "String (timestamp)",
"feedbackResourcesFolderUrl": "String",
"grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
"id": "String (identifier)",
"instructions": {"@odata.type": "microsoft.graph.itemBody"},
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"moduleUrl": "String",
"notificationChannelUrl": "String",
"resourcesFolderUrl": "String",
"status": "String",
"webUrl": "String"
}