Criar educationSchool

Namespace: microsoft.graph

Crie um novo objeto educationSchool .

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ❌ ❌ ❌

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) Sem suporte. Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo EduRoster.ReadWrite.All Indisponível.

Solicitação HTTP

POST /education/schools

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto educationSchool .

A tabela a seguir lista as propriedades necessárias quando você cria a educationSchool.

Propriedade Tipo Descrição
displayName Cadeia de caracteres Nome de exibição da escola. Herdado de educationOrganization.
description Cadeia de caracteres Descrição da escola. Herdado de educationOrganization.
externalSource educationExternalSource Origem de onde esta organização foi criada. Herdado de educationOrganization. Os valores possíveis são: sis, 'manual.
externalSourceDetail Cadeia de caracteres O nome da fonte externa a partir da qual esse recurso foi gerado.
principalEmail Cadeia de caracteres Endereço de email da entidade de segurança.
principalName Cadeia de caracteres Nome da entidade de segurança.
externalPrincipalId Cadeia de caracteres ID da entidade de segurança no sistema de sincronização.
highestGrade Cadeia de caracteres Ensino de nível mais alto.
lowestGrade Cadeia de caracteres Ensino de nível mais baixo.
schoolNumber Cadeia de caracteres Número da escola.
externalId Cadeia de caracteres ID da escola no sistema de sincronização.
phone Cadeia de caracteres Número de telefone da escola.
fax Cadeia de caracteres Número de fax da escola.
createdBy identitySet Entidade que criou a escola.
address physicalAddress Endereço da escola.

Resposta

Se bem-sucedido, esse método retornará um código de resposta 201 Created e um objeto educationSchool no corpo da resposta.

Exemplos

Solicitação

POST https://graph.microsoft.com/v1.0/education/schools
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.educationSchool",
  "displayName": "String",
  "description": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "principalEmail": "String",
  "principalName": "String",
  "externalPrincipalId": "String",
  "lowestGrade": "String",
  "highestGrade": "String",
  "schoolNumber": "String",
  "externalId": "String",
  "phone": "String",
  "fax": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "address": {
    "@odata.type": "microsoft.graph.physicalAddress"
  }
}

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.educationSchool",
  "id": "1c23c12e-c12e-1c23-2ec1-231c2ec1231c",
  "displayName": "String",
  "description": "String",
  "externalSource": "String",
  "externalSourceDetail": "String",
  "principalEmail": "String",
  "principalName": "String",
  "externalPrincipalId": "String",
  "lowestGrade": "String",
  "highestGrade": "String",
  "schoolNumber": "String",
  "externalId": "String",
  "phone": "String",
  "fax": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "address": {
    "@odata.type": "microsoft.graph.physicalAddress"
  }
}