Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 tareas contienen documentos y tareas en las que el profesor quiere que trabaje el alumno. Cada tarea del alumno tiene una entrega asociada que contiene cualquier trabajo que su profesor haya pedido que se entregue. Solo los profesores o los propietarios de equipos pueden crear tareas. Un profesor puede agregar puntajes y comentarios a la entrega entregada por el estudiante.
Cuando se crea una tarea , se encuentra en estado de borrador. Los alumnos no pueden ver la tarea y no se crean envíos . Puede cambiar el estado de una asignación mediante la acción de publicación . No 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 | educationAssignment | Crear una tarea nueva. |
| Get | educationAssignment | Read las propiedades y relaciones de un objeto educationAssignment . |
| Actualizar | educationAssignment | Actualizar un objeto educationAssignment . |
| Delete | Ninguno | Eliminar un objeto educationAssignment . |
| Publicar | educationAssignment | Cambiar el estado de un objeto educationAssignment de borrador a publicado. |
| Crear recursos de la tarea | educationAssignmentResource | Crear un recurso de asignación. |
| Obtener recursos de tareas | educationAssignmentResource | Obtenga las propiedades de un recurso de tarea educativa asociado a una tarea. |
| Eliminar recurso de asignación | Ninguno | Eliminar un recurso de tarea educativa específico adjunto a una tarea. |
| 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 la tarea | educationAssignment | Cree una carpeta de SharePoint para cargar archivos de comentarios para un EducationSubmission determinado. |
| Enumerar recursos | educationAssignmentColección de recursos | Obtener una colección de objetos educationAssignmentResource . |
| Enumerar envíos | educationSubmission collection | Obtener una colección de objetos educationSubmission . |
| Enumerar categorías | Colección educationCategory | Obtener una colección de objetos educationCategory . |
| Agregar categorías | educationCategory | Asigna un EducationCategory que pertenezca a la clase a esta tarea. |
| Quitar categoría | Ninguno | Quite de esta tarea una EducationCategory que pertenezca a la clase. |
| Adjuntar rúbrica | Ninguno | Adjunte una rúbrica educativa existente a esta tarea. |
| Quitar criterio de evaluación | Ninguno | Separe la rúbrica de educación de esta tarea. |
| Obtener delta | Colección educationAssignment | Obtenga una lista de tareas recién creadas o actualizadas sin tener que realizar una lectura completa de la colección. |
| Agregar categoría de calificación | educationGradingCategory | Agregue ratingingCategory publicando en la colección gradingCategory . |
| Quitar categoría de calificación | Ninguno | Quite un objeto educationGradingCategory . |
| Activar asignación | educationAssignment | Activar una EducationAssignment inactiva para indicar que la tarea tiene más elementos de acción para profesores o alumnos. |
| Desactivar asignación | educationAssignment | Marcar una EducationAssignment asignada como inactiva para indicar que la tarea no tiene más elementos de acción para los profesores y los alumnos. |
| Agregar esquema de calificaciones | educationGradingScheme | Agregar un educationGradingScheme existente a un educationAssignment existente. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| addedStudentAction | Cadena | Campo opcional para controlar el comportamiento de la tarea de los alumnos que se agregan después de publicar la tarea . Si no se especifica, el valor predeterminado es none. Los valores admitidos son: none, assignIfOpen. Por ejemplo, un profesor puede usarlo assignIfOpen para indicar que se debe asignar una tarea a cualquier alumno nuevo que se una a la clase mientras la tarea aún está abierta, así como none para indicar que no se debe asignar una tarea a los alumnos nuevos. |
| addToCalendarAction | educationAddToCalendarOptions | Campo opcional para controlar el comportamiento de la tarea de agregar tareas a los calendarios de los alumnos y profesores cuando se publique la tarea . Los valores posibles son: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValuey studentsOnly. Use el encabezado de solicitud Prefer: include-unknown-enum-members para obtener los siguientes miembros en esta enumeración evolutiva: studentsOnly. El valor predeterminado es none. |
| allowLateSubmissions | Booleano | Identifica si los alumnos pueden enviar el envío 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 una entrega o si solo pueden modificar los recursos agregados por el profesor. |
| assignDateTime | DateTimeOffset | La fecha en la que la tarea debe activarse. Si está en el futuro, la tarea no se muestra al alumno hasta esta fecha. El tipo de marca de tiempo 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 qué clase entera debe recibir un objeto de envío una vez publicada la tarea . |
| assignedDateTime | DateTimeOffset | El momento en que se publicó la tarea para los alumnos y la tarea se muestra 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 tarea . |
| closeDateTime | DateTimeOffset | Fecha en la que se cerrará la tarea para las entregas. Este es un campo opcional que puede ser null si la asignación no permite LateSubmissions o cuando closeDateTime es el mismo que dueDateTime. Sin embargo, 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 tarea. |
| createdDateTime | DateTimeOffset | Momento en que se creó la tarea . 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 tarea. |
| dueDateTime | DateTimeOffset | Fecha de vencimiento de la tarea 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 la carpeta donde se almacenan todos los recursos del archivo de comentarios para esta tarea . |
| Calificación | educationAssignmentGradeType | Cómo se calificará la tarea . |
| id | Cadena | El identificador único de la asignación. Heredado de la entidad. Solo lectura. |
| Instrucciones | itemBody | Instrucciones para la tarea. Esta propiedad y el nombre para mostrar indican al alumno qué hacer. |
| languageTag | Cadena | Especifica el idioma en el que se muestran las notificaciones de la interfaz de usuario para la tarea. Si no se proporciona languageTag , el idioma predeterminado es en-US. Opcional. |
| lastModifiedBy | identitySet | Quién modificó por última vez la tarea. |
| lastModifiedDateTime | DateTimeOffset | La fecha y hora en que se modificó la tarea . El envío de un alumno no modifica la tarea; Solo los profesores pueden actualizar las tareas. 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 | La dirección URL del módulo desde el que se va a acceder a la tarea. |
| notificationChannelUrl | Cadena | Campo opcional para especificar la dirección URL del canal para publicar la notificación de publicación de la tarea . Si no se especifica o es null, el valor predeterminado es el General canal. Este campo solo se aplica a las tareas en las que el valor assignTo es educationAssignmentClassRecipient. No se permite actualizar notificationChannelUrl después de que se haya publicado la tarea . |
| resourcesFolderUrl | string | Dirección URL de la carpeta en la que se almacenan todos los recursos de archivo para esta tarea . |
| status | cadena | Estado de la asignación. No puede aplicar revisiones a este valor. Los valores posibles son: draft, scheduled, published, assigned, unknownFutureValue, inactive. Use el encabezado de solicitud Prefer: include-unknown-enum-members para obtener los siguientes miembros en esta enumeración evolutiva: inactive. |
| webUrl | string | La dirección URL del vínculo profundo para la tarea especificada. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| recursos | educationAssignmentColección de recursos | Objetos de aprendizaje asociados a esta tarea. Solo los profesores pueden modificar esta lista. Admite valores NULL. |
| Envíos | educationSubmission collection | Una vez publicado, hay un objeto de envío para cada estudiante 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 asignaciones de un tipo determinado. Solo lectura. Admite valores NULL. |
| Rúbrica | educationRubric | Cuando se establece, la rúbrica de calificación se adjunta a esta tarea. |
| gradingCategory | educationGradingCategory collection | Cuando se establece, permite a los usuarios ponderar las tareas de manera diferente al calcular una calificación promedio de clase. |
| gradingScheme | educationGradingScheme | Cuando se establece, permite a los usuarios configurar calificaciones de cadena personalizadas basadas en el porcentaje del total de puntos obtenidos en esta tarea. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"addedStudentAction": "String",
"addToCalendarAction": "String",
"allowLateSubmissions": "Boolean",
"allowStudentsToAddResourcesToSubmission": "Boolean",
"assignDateTime": "String (timestamp)",
"assignedDateTime": "String (timestamp)",
"assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
"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"},
"languageTag": "String",
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"moduleUrl": "String",
"notificationChannelUrl": "String",
"resourcesFolderUrl": "String",
"status": "String",
"webUrl": "String"
}