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"
}