Partager via


Création d’un objet educationSchool

Espace de noms: microsoft.graph

Créez un objet educationSchool .

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Non prise en charge. Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application EduRoster.ReadWrite.All Non disponible.

Requête HTTP

POST /education/schools

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet educationSchool .

Le tableau suivant répertorie les propriétés qui sont requises lorsque vous créez educationSchool.

Propriété Type Description
displayName String Nom d’affichage de l’établissement scolaire. Héritée de educationOrganization.
description String Description de l’établissement scolaire. Héritée de educationOrganization.
externalSource educationExternalSource Source à partir de laquelle cette organization a été créée. Héritée de educationOrganization. Les valeurs possibles sont : sis, 'manual.
externalSourceDetail Chaîne Nom de la source externe à partir de laquelle ces ressources ont été générées.
principalEmail String Adresse e-mail du principal.
principalName String Nom du principal.
externalPrincipalId String ID du principal dans le système de synchronisation.
highestGrade String Niveau d’enseignement le plus haut enseigné.
lowestGrade String Niveau d’enseignement le plus bas enseigné.
schoolNumber String Numéro de l’établissement.
externalId String ID de l’établissement scolaire dans le système de synchronisation.
phone String Numéro de téléphone de l’établissement scolaire.
fax String Numéro de fax de l’établissement scolaire.
createdBy identitySet Entité qui a créé l’établissement scolaire.
address physicalAddress Adresse de l’établissement scolaire.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 201 Created et un objet educationSchool dans le corps de la réponse.

Exemples

Demande

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

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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