Tipo de recurso educationClass
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.
Representa uma aula em uma escola. O recurso educationClass corresponde atualmente a um grupo do Microsoft 365 e partilha o mesmo ID. Os estudantes são membros regulares da turma e os Professores são proprietários e têm direitos adequados.
Importante
Para que as experiências do Microsoft 365 funcionem corretamente, os professores têm de ser membros das coleções de professores e membros.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Obter classe | educationClass | Leia as propriedades e relações de um objeto educationClass. |
| Adicionar membro | educationUser | Adicione um novo educationUser para a aula postando na propriedade de navegação de membros. |
| Listar membros | Coleção educationUser | Obtenha uma coleção de objetos educationUser. |
| Remover membro | educationUser | Remova um educationUser da aula por meio da propriedade de navegação de membros. |
| Listar escolas | Coleção educationSchool | Obtenha uma coleção de objetos educationSchool. |
| Adicionar professor | educationUser | Adicione um novo educationUser para a aula postando na propriedade de navegação de professores. |
| Listar professores | Coleção educationUser | Obtenha uma lista de professores para a aula. |
| Remover professor | educationUser | Remova um educationUser da aula por meio da propriedade de navegação de professores. |
| Create | educationAssignment | Crie um novo educationAssignment ao publicar na coleção de tarefas. |
| Listar tarefas | coleção educationAssignment | Obtenha uma coleção de objetos educationAssignment . |
| Listar módulos | coleção educationModule | Obter uma coleção de objetos educationModule . |
| Obter grupo | group | Obtenha o grupo do Microsoft 365 que corresponde a este educationClass. |
| Criar categoria | educationCategory | Crie uma nova educationCategory para esta turma. |
| Listar categorias | coleção educationCategory | Obtenha uma lista de objetos educationCategory que pertencem a esta turma. |
| Atualizar classe | educationClass | Atualize o objeto educationClass. |
| Excluir classe | Nenhum | Exclua o objeto educationClass. |
| Obter delta | Coleção educationClass | Obter alterações incrementais para educationClasses. |
| Obter submissões modificadas recentemente | educationSubmission collection (coleção educationSubmission ) | Obter submissões modificadas nos sete dias anteriores. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | Cadeia de caracteres | O identificador exclusivo da aula. |
| classCode | Cadeia de caracteres | Código de aula usada pela escola para identificar a aula. |
| curso | educationCourse | Informações do curso para a turma. |
| createdBy | identitySet | Entidade que criou a classe. |
| description | Cadeia de caracteres | Descrição da aula. |
| displayName | Cadeia de caracteres | Nome da aula. |
| externalId | Cadeia de caracteres | ID da aula no sistema de sincronização. |
| externalName | Cadeia de caracteres | Nome da aula no sistema de sincronização. |
| externalSource | Cadeia de caracteres | O tipo de origem externa a partir da quais este recurso foi gerado (determinado automaticamente a partir de externalSourceDetail). Os valores possíveis são: sis, lms ou manual. |
| externalSourceDetail | Cadeia de caracteres | O nome da origem externa a partir da qual este recurso foi gerado. |
| grade | Cadeia de caracteres | Nível de nota da turma. |
| mailNickname | Cadeia de caracteres | Nome de email para enviar email a todos os membros, se essa propriedade estiver habilitada. |
| term | educationTerm | Termo para a classe . |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| assignments | coleção educationAssignment | Todas as tarefas associadas a esta classe. Anulável. |
| members | Coleção educationUser | Todos os usuários da aula. Anulável. |
| módulos | coleção educationModule | Todos os módulos na classe . Anulável. |
| schools | Coleção educationSchool | Todas as escolas às quais essa aula está associada. Anulável. |
| teachers | Coleção educationUser | Todos os professores da aula. Anulável. |
| assignmentCategories | coleção educationCategory | Todas as categorias associadas a esta classe. Anulável. |
| assignmentDefaults | educationAssignmentDefaults collection | Especifica as predefinições de nível de classe respeitadas pelas novas tarefas criadas na classe . |
| assignmentSettings | coleção educationAssignmentSettings | Especifica as definições de tarefas ao nível da classe. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"classCode": "String",
"course": { "@odata.type": "microsoft.graph.educationCourse" },
"createdBy": { "@odata.type": "microsoft.graph.identitySet" },
"description": "String",
"displayName": "String",
"externalId": "String",
"externalName": "String",
"externalSource": "string",
"grade": "string",
"id": "String (identifier)",
"mailNickname": "String",
"term": { "@odata.type": "microsoft.graph.educationTerm" }
}