tipo de recurso educationAssignment

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 atribuições contêm apostilas e tarefas em que o professor deseja que o aluno trabalhe. Cada atribuição de aluno tem um envio associado que contém qualquer trabalho que seu professor pediu para ser entregue. Somente professores ou proprietários de equipe podem criar atribuições. 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 atribuição e os envios não são criados. Você pode alterar o status de uma atribuição usando a ação de publicação. Você não pode usar uma solicitação PATCH para alterar o status de atribuição.

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

Herda de entidade.

Methods

Método	Tipo de retorno	Descrição
Criar recurso de tarefa	educationAssignmentResource	Crie um novo educationAssignmentResource postando na coleção de recursos.
Obter a tarefa	educationAssignment	Leia propriedades e relações de um objeto educationAssignment .
Atualizar	educationAssignment	Atualize um objeto educationAssignment .
Delete	Nenhum	Excluir um objeto educationAssignment .
Publish	educationAssignment	Altere o estado de um objeto educationAssignment de rascunho para publicado.
Configurar a pasta de recursos de atribuição	string	Crie uma pasta do SharePoint (em local predefinido) para carregar arquivos como recursos de atribuição.
Configurar a pasta de recursos de comentários de atribuição	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 um educationCategory pertencente à classe a essa atribuição.
Remover categoria	Nenhum	Remova um educationCategory pertencente à classe desta atribuição.
Anexar rubrica	Nenhum	Anexar um educationRubric existente a essa atribuição.
Remover rubrica	Nenhum	Desanexe o educationRubric desta atribuição.
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 educationGradingCategory	educationGradingCategory	Adicione um educationGradingCategory à coleção educationGradingCategory .
Remover educationGradingCategory	Nenhum	Remova um objeto educationGradingCategory da coleção educationGradingCategory .
Ativar atribuição	educationAssignment	Ativar um inactiveeducationAssignment para sinalizar que a atribuição tem outros itens de ação para professores ou alunos.
Desativar atribuição	educationAssignment	Marque um assignededucationAssignment como inactive para sinalizar que a atribuição não tem mais itens de ação para professores e alunos.

Propriedades

Propriedade	Tipo	Descrição
addedStudentAction	Cadeia de caracteres	Campo opcional para controlar o comportamento de atribuição para os alunos que são adicionados após a publicação da atribuição . Se não for especificado, o padrão será none. Os valores com suporte são: none, assignIfOpen. Por exemplo, um professor pode usar assignIfOpen para indicar que uma atribuição deve ser atribuída a qualquer novo aluno que ingresse na classe enquanto a atribuição ainda está aberta, e none para indicar que uma atribuição não deve ser atribuída a novos alunos.
addToCalendarAction	educationAddToCalendarOptions	Campo opcional para controlar o comportamento de atribuição para adicionar atribuições aos calendários dos alunos e professores quando a atribuição for publicada. Os valores possíveis são: none, , studentsAndTeamOwnersstudentsAndPublisher, , unknownFutureValuee studentsOnly. Você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter os seguintes valores neste enumerável em evolução: studentsOnly. O valor padrão é none.
allowLateSubmissions	Booliano	Identifica se os alunos podem enviar após a data de vencimento. Se essa propriedade não for especificada durante a criação, ela será padrão para true.
allowStudentsToAddResourcesToSubmission	Booliano	Identifica se os alunos podem adicionar seus próprios recursos a um envio ou se só podem modificar recursos adicionados pelo professor.
assignDateTime	DateTimeOffset	A data em que a atribuição deve ficar ativa. Se, no futuro, a atribuição não for mostrada ao aluno até esta data. O tipo carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em tempo UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
assignTo	educationAssignmentRecipient	Quais usuários ou classe inteira devem receber um objeto de envio depois que a atribuição for publicada.
assignedDateTime	DateTimeOffset	O momento em que a atribuição foi publicada para os alunos e a atribuição aparece nos alunos linha do tempo. 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 essa atribuição pertence.
closeDateTime	DateTimeOffset	Data em que a atribuição é fechada para envios. Esse é um campo opcional que pode ser nulo se a atribuição não permitirLateSubmissions ou quando o closeDateTime for o mesmo que o 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 atribuição dos alunos é 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 de pasta em que todos os recursos de arquivo de comentários para essa atribuição são armazenados.
Classificação	educationAssignmentGradeType	Como a atribuição será classificada.
id	Cadeia de caracteres	O identificador exclusivo para a atribuição. Herdado da entidade. Somente leitura.
Instruções	itemBody	Instruções para a atribuição. As instruções e o nome de exibição dizem ao aluno o que fazer.
lastModifiedBy	identitySet	Quem modificou a atribuição pela última vez.
lastModifiedDateTime	DateTimeOffset	A data e a hora em que a atribuição foi modificada. Um envio de aluno não modifica a atribuição; somente professores podem atualizar atribuições. 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	cadeia de caracteres	A URL do módulo do qual acessar a atribuição.
notificationChannelUrl	Cadeia de caracteres	Campo opcional para especificar a URL do canal para postar a notificação de publicação de atribuição . Se não for especificado ou nulo, o padrão será para o General canal. Esse campo só se aplica a atribuições em que o valor assignTo é educationAssignmentClassRecipient. A atualização da notificaçãoChannelUrl não é permitida após a publicação da atribuição.
resourcesFolderUrl	cadeia de caracteres	URL de pasta em que todos os recursos de arquivo para essa atribuição são armazenados.
status	educationAssignmentStatus	Status da atribuição. Você não pode CORRIGIR esse valor. Os possíveis valores são: draft, scheduled, published, assigned, unknownFutureValue, inactive. Observe que você deve usar o Prefer: include-unknown-enum-members cabeçalho de solicitação para obter os seguintes valores neste enumerável em evolução: inactive.
webUrl	cadeia de caracteres	A URL de link profundo para a atribuição determinada.

Relações

Relação	Tipo	Descrição
categories	coleção educationCategory	Quando definido, permite que os usuários encontrem facilmente atribuições de um determinado tipo. Somente leitura. Anulável.
recursos	coleção educationAssignmentResource	Objetos de aprendizagem associados a essa atribuição. Somente professores podem modificar essa lista. Anulável.
Rubrica	educationRubric	Quando definido, a rubrica de classificação anexada a essa atribuição.
Submissões	coleção educationSubmission	Uma vez publicado, há um objeto de envio para cada aluno que representa seu trabalho e sua nota. Somente leitura. Anulável.
gradingCategory	coleção educationGradingCategory	Quando definido, permite que os usuários ponderem as atribuições de forma diferente ao calcular uma nota média de classe.

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"},
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "moduleUrl": "String",
  "notificationChannelUrl": "String",
  "resourcesFolderUrl": "String",
  "status": "String",  
  "webUrl": "String"
}