Compartilhar via


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 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.

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 um 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 atribuições recém-criadas ou atualizadas sem precisar executar uma leitura completa da coleção.
Adicionar educationGradingCategory educationGradingCategory Adicione gradingCategory postando na coleção gradingCategory.
Remover educationGradingCategory Nenhum Remova um objeto educationGradingCategory .
Ativar atribuição educationAssignment Ativar uma educação inativaAssignment para sinalizar que a atribuição tem outros itens de ação para professores ou alunos.
Desativar atribuição educationAssignment Marque um educationAssignment atribuído como inativo 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 Prefer: include-unknown-enum-members cabeçalho de 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 será 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. Essa propriedade e o nome de exibição informam 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 cadeia de caracteres Status da atribuição. Você não pode CORRIGIR esse valor. Os possíveis valores são: draft, scheduled, published, assigned, unknownFutureValue, inactive. 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
recursos coleção educationAssignmentResource Objetos de aprendizagem associados a essa atribuição. Somente professores podem modificar essa lista. Anulável.
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.
categories coleção educationCategory Quando definido, permite que os usuários encontrem 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.
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"
 
}