Partager via


Mettre à jour educationSchool

Espace de noms: microsoft.graph

Mettez à jour les propriétés d’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

PATCH /education/schools/{id}

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json

Corps de la demande

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

Le tableau suivant indique les propriétés requises lorsque vous mettez à jour 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 les suivantes : 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 200 OK et un objet educationSchool mis à jour dans le corps de la réponse.

Exemple

Demande

L’exemple suivant illustre une demande.

PATCH https://graph.microsoft.com/v1.0/education/schools/{school-id}
Content-type: application/json

{
  "displayName": "Fabrikam Arts High School",
  "description": "Magnate school for the arts. Los Angeles School District"
}

Réponse

L’exemple suivant illustre la réponse.

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

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "10002",
  "displayName": "Fabrikam Arts High School",
  "description": "Magnate school for the arts. Los Angeles School District",
  "status": "String",
  "externalSource": "String",
  "principalEmail": "AmyR@fabrikam.com",
  "principalName": "Amy Roebuck",
  "externalPrincipalId": "14007",
  "highestGrade": "12",
  "lowestGrade": "9",
  "schoolNumber": "10002",
  "address": {
    "city": "Los Angeles",
    "countryOrRegion": "United States",
    "postalCode": "98055",
    "state": "CA",
    "street": "12345 Main St."
  },
  "externalId": "10002",
  "phone": "+1 (253) 555-0102"
}