tipo de recurso educationAssignment

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor de versão.

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.

Somente professores ou proprietários de equipe podem criar tarefas. As tarefas contêm folhetos e tarefas nas qual o professor deseja que o aluno trabalhe. Cada tarefa de aluno tem um envio associado que contém qualquer trabalho que seu professor pediu para ser entregue. 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 serã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 da atribuição .

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

Métodos

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	Ler propriedades e relações de um objeto educationAssignment .
Atualizar	educationAssignment	Atualize um objeto educationAssignment .
Excluir	Nenhum	Exclua um objeto educationAssignment.
Publicar	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 uma determinada 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 que pertence à classe a esta tarefa.
Remover categoria	Nenhum	Remova uma educationCategory que pertence à classe desta tarefa.
Anexar rubric	Nenhum	Anexe um educationRubric existente a essa tarefa.
Remover rubrica	Nenhum	Desanexe o educationRubric desta tarefa.
Obter delta	coleção educationAssignment	Obtenha uma lista de atribuições recém-criadas ou atualizadas sem precisar executar uma leitura completa da coleção.

Propriedades

Propriedade	Tipo	Descrição
id	String	Somente leitura.
addedStudentAction	Cadeia de Caracteres	Campo opcional para controlar o comportamento da tarefa para alunos que são adicionados após a publicação da tarefa. Se não for especificado, o valor será padrão none . Atualmente, dá suporte a apenas dois valores: none ou assignIfOpen.
addToCalendarAction	educationAddToCalendarOptions	Campo opcional para controlar o comportamento da tarefa para adicionar tarefas aos calendários dos alunos e professores quando a tarefa é publicada. Os valores possíveis são: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValuee studentsOnly. Observe que você deve usar o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores nesta enumeração evolvável: studentsOnly. O valor padrão é none.
allowLateSubmissions	Booliano	Identifica se os alunos podem enviar após a data de conclusão. 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 eles 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 for mostrada ao aluno até essa data. O tipo de carimbo de data /hora 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 classe inteira devem receber um objeto de envio depois que a atribuição for publicada.
assignedDateTime	DateTimeOffset	O momento em que a tarefa foi publicada para os alunos e a tarefa aparece na 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 atribuição será fechada para envios. Este é um campo opcional que pode ser nulo se a atribuição não permitirLateSubmissions ou quando closeDateTime for igual ao dueDateTime. Mas, se especificado, 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 tarefa.
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	String	Nome da atribuição.
dueDateTime	DateTimeOffset	Data de conclusão da tarefa 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
feedbackResourcesFolderUrl	String	URL da pasta em que todos os recursos do arquivo de comentários para essa atribuição são armazenados.
Classificação	educationAssignmentGradeType	Como a tarefa será classificada.
Instruções	itemBody	Instruções para a atribuição. Isso junto com o nome de exibição informa ao aluno o que fazer.
lastModifiedBy	identitySet	Quem modificou a tarefa pela última vez.
lastModifiedDateTime	DateTimeOffset	Momento em que a atribuição foi modificada pela última vez. 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
notificationChannelUrl	String	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á o General canal. Esse campo só se aplica a atribuições em que o valor assignTo é educationAssignmentClassRecipient. A atualização do notificationChannelUrl não é permitida após a publicação da atribuição.
status	cadeia de caracteres	Status da atribuição. Você não pode APLICAR PATCH a esse valor. Os valores possíveis são: draft, scheduled, published, assigned.
webUrl	cadeia de caracteres	A URL de link profundo para a atribuição fornecida.
resourcesFolderUrl	string	URL da pasta em que todos os recursos de arquivo para essa atribuição são armazenados.

Relações

Relação	Tipo	Descrição
recursos	coleção educationAssignmentResource	Aprender objetos associados a essa atribuição. Somente professores podem modificar essa lista. Anulável.
Submissões	coleção educationSubmission	Depois de publicado, há um objeto de envio para cada aluno que representa seu trabalho e nota. Somente leitura. Anulável.
categories	coleção educationCategory	Quando definido, permite que os usuários localizem facilmente atribuições de um determinado tipo. Somente leitura. Anulável.
Rubrica	educationRubric	Quando definido, a rubrica de classificação anexada a essa atribuição.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "id": "String (identifier)",
  "addedStudentAction": "none",
  "addToCalendarAction": "string",
  "allowLateSubmissions": true,
  "allowStudentsToAddResourcesToSubmission": true,
  "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)",
  "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
  "instructions": {"@odata.type": "microsoft.graph.itemBody"},
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "notificationChannelUrl": "string",
  "status": "string",
  "webUrl": "string",
  "resourcesFolderUrl": "string"
}