educationAssignment tipo de recurso

Namespace: microsoft.graph

As atribuições são tarefas ou unidades de trabalho atribuídas a um aluno ou membro da equipe em uma classe como parte do estudo.

As tarefas contêm folhetos e tarefas nas quais o professor deseja que o aluno trabalhe. Cada tarefa do aluno tem um envio associado que contém qualquer trabalho que o professor solicitou para ser entregue. Somente professores ou proprietários de equipe podem criar tarefas. Um professor pode adicionar pontuações e comentários ao envio entregue pelo aluno.

Quando uma atribuição é criada, ela está em um estado de rascunho. Os alunos não podem ver a tarefa e os envios não são criados. Você pode alterar o status de uma tarefa usando a ação de publicação. Você não pode usar uma solicitação PATCH para alterar o status da atribuição.

As APIs de atribuição são expostas no namespace da classe.

Herda de entidade.

Methods

Método Tipo de retorno Descrição
Criar educationAssignment Crie uma nova atribuição.
Get educationAssignment Leia as propriedades e as relações de um objeto educationAssignment .
Atualizar educationAssignment Atualize um objeto educationAssignment.
Delete Nenhum Exclua um objeto educationAssignment .
Publish educationAssignment Altere o estado de um objeto educationAssignment de rascunho para publicado.
Criar recurso de tarefa educationAssignmentResource Crie um recurso de atribuição.
Obter recurso de tarefa educationAssignmentResource Obtenha as propriedades de um recurso de atribuição educacional associado a uma tarefa.
Excluir recurso de atribuição Nenhum Exclua um recurso de tarefa de educação específico anexado a uma tarefa.
Configurar a pasta de recursos de atribuição string Crie uma pasta do SharePoint (em um local predefinido) para carregar arquivos como recursos de atribuição.
Configurar a pasta de recursos de comentários da tarefa educationAssignment Crie uma pasta do SharePoint para carregar arquivos de comentários para um determinado educationSubmission.
Listar recursos coleção educationAssignmentResource Obtenha uma coleção de objetos educationAssignmentResource .
Listar envios coleção educationSubmission Obtenha uma coleção de objetos educationSubmission .
Listar categorias coleção educationCategory Obtenha uma coleção de objetos educationCategory .
Adicionar categorias educationCategory Atribua uma educationCategory pertencente à classe para esta tarefa.
Remover categoria Nenhum Remova um educationCategory pertencente à classe dessa tarefa.
Anexar rubrica Nenhum Anexe uma educationRubric existente a esta tarefa.
Remover rubrica Nenhum Desanexe a educationRubric desta tarefa.
Obter delta coleção educationAssignment Obtenha uma lista de objetos educationAssignment recém-criados ou atualizados sem precisar executar uma leitura completa da coleção.
Adicionar categoria de classificação educationGradingCategory Adicione um gradingCategory a um educationAssignment.
Remover categoria de classificação Nenhum Remova um gradingCategory de um educationAssignment.
Ativar atribuição educationAssignment Ative um inactiveeducationAssignment para sinalizar que a tarefa tem outros itens de ação para professores ou alunos.
Desativar atribuição educationAssignment Marque um assignededucationAssignment para inactive sinalizar que a atribuição não tem mais itens de ação para professores e alunos.
Adicionar esquema de classificação educationGradingScheme Adicione um educationGradingScheme existente a um educationAssignment existente.

Propriedades

Propriedade Tipo Descrição
addedStudentAction Cadeia de caracteres Campo opcional para controlar o comportamento da tarefa para os alunos adicionados após a publicação da tarefa . Se não for especificado, o padrão é none. Os valores com suporte são: none, assignIfOpen. Por exemplo, um professor pode usar assignIfOpen para indicar que uma tarefa deve ser atribuída a qualquer novo aluno que ingresse na classe enquanto a tarefa ainda estiver aberta e none para indicar que uma tarefa não deve ser atribuída a novos alunos.
addToCalendarAction educationAddToCalendarOptions Campo opcional para controlar o comportamento da atribuição para adicionar tarefas aos calendários de alunos e professores quando a tarefa for publicada. Os valores possíveis são: none, studentsAndPublisher, studentsAndTeamOwnersunknownFutureValue, e studentsOnly. Use o cabeçalho da Prefer: include-unknown-enum-members solicitação para obter os seguintes valores nesta enumeração evolutiva: studentsOnly. O valor padrão é none.
allowLateSubmissions Booliano Identifica se os alunos podem enviar após a data de entrega. Se essa propriedade não for especificada durante a criação, o padrão será true.
allowStudentsToAddResourcesToSubmission Booliano Identifica se os alunos podem adicionar seus próprios recursos a um envio ou se só podem modificar os recursos adicionados pelo professor.
assignDateTime DateTimeOffset A data em que a atribuição deve ficar ativa. Se, no futuro, a tarefa não será mostrada ao aluno até essa data. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
assignTo educationAssignmentRecipient Quais usuários ou a classe inteira devem receber um objeto de envio assim que a tarefa for publicada.
assignedDateTime DateTimeOffset O momento em que a tarefa foi publicada para os alunos e a tarefa aparece na linha do linha do tempo dos alunos. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
classId Cadeia de caracteres Classe à qual esta tarefa pertence.
closeDateTime DateTimeOffset Data em que a tarefa é encerrada para envios. Este é um campo opcional que pode ser nulo se a atribuição não allowLateSubmissions ou quando closeDateTime for igual a dueDateTime. Mas, se especificado, o closeDateTime deve ser maior ou igual ao dueDateTime. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
createdBy identitySet Quem criou a atribuição.
createdDateTime DateTimeOffset Momento em que a atribuição foi criada. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
displayName Cadeia de caracteres Nome da atribuição.
dueDateTime DateTimeOffset Data em que a tarefa do aluno é devida. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
feedbackResourcesFolderUrl Cadeia de caracteres URL da pasta em que todos os recursos do arquivo de comentários para esta tarefa estão armazenados.
Classificação educationAssignmentGradeType Como a tarefa será avaliada.
id Cadeia de caracteres O identificador exclusivo da tarefa. Herdado da entidade. Somente leitura.
Instruções itemBody Instruções para a tarefa. As instruções e o nome de exibição informam ao aluno o que fazer.
languageTag Cadeia de caracteres Especifica o idioma no qual as notificações da interface do usuário para a atribuição são exibidas. Se languageTag não for fornecido, o idioma padrão será en-US. Opcional.
lastModifiedBy identitySet Quem modificou a atribuição pela última vez.
lastModifiedDateTime DateTimeOffset A data e hora em que a atribuição foi modificada. O envio de um aluno não modifica a tarefa; Somente professores podem atualizar as tarefas. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
moduleUrl string A URL do módulo a partir do qual acessar a tarefa.
notificationChannelUrl Cadeia de caracteres Campo opcional para especificar a URL do canal para postar a notificação de publicação da tarefa . Se não for especificado ou for nulo, o padrão é o General canal. Este campo só se aplica a tarefas em que o valor assignTo é educationAssignmentClassRecipient. Atualizar o notificationChannelUrl não é permitido depois que a atribuição é publicada.
resourcesFolderUrl string URL da pasta em que todos os recursos de arquivo para esta atribuição estão armazenados.
status educationAssignmentStatus Status da atribuição. Você não pode corrigir este valor. Os valores possíveis são: draft, scheduled, published, assigned, unknownFutureValue, inactive. Use o cabeçalho da Prefer: include-unknown-enum-members solicitação para obter os seguintes membros nesta enumeração evolutiva: inactive.
webUrl string A URL do link profundo para a tarefa determinada.

Relações

Relação Tipo Descrição
categories coleção educationCategory Quando definido, permite que os usuários localizem facilmente atribuições de um determinado tipo. Somente leitura. Anulável.
gradingCategory coleção educationGradingCategory Quando definido, permite que os usuários ponderem as tarefas de forma diferente ao calcular a nota média de uma turma.
gradingScheme educationGradingScheme Quando definido, permite que os usuários configurem notas de cadeia de caracteres personalizadas com base na porcentagem do total de pontos ganhos nesta tarefa.
recursos coleção educationAssignmentResource Objetos de aprendizagem associados a essa tarefa. Somente professores podem modificar esta lista. Anulável.
rubrica educationRubric Quando definida, a rubrica de classificação anexada a esta tarefa.
Envios coleção educationSubmission Depois de publicado, há um objeto de envio para cada aluno representando seu trabalho e nota. Somente leitura. Anulável.

Representação JSON

A representação JSON a seguir mostra o 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"},
  "languageTag": "String",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "moduleUrl": "String",
  "notificationChannelUrl": "String",
  "resourcesFolderUrl": "String",
  "status": "String",  
  "webUrl": "String"
}
  • Last updated on