educationSchool : DeltaeducationSchool: delta

Espace de noms: microsoft.graphNamespace: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph peuvent faire l’objet de modifications.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version .To determine whether an API is available in v1.0, use the Version selector.

Obtenir des établissements scolaires nouvellement créés ou mis à jour sans avoir à effectuer une lecture complète de l’ensemble de l’établissement scolaire.Get newly created or updated schools without having to perform a full read of the entire school collection. Pour plus d’informations, voir utiliser une requête Delta .See Use delta query for details.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) EduRoster. ReadBasic, EduRoster. Read ou EduRoster. ReadWriteEduRoster.ReadBasic, EduRoster.Read, or EduRoster.ReadWrite
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication EduRoster. ReadBasic. All, EduRoster. Read. All ou EduRoster. WriteWrite. AllEduRoster.ReadBasic.All, EduRoster.Read.All, or EduRoster.WriteWrite.All

Requête HTTPHTTP request

GET /education/schools/delta

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {code}Bearer {code}

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un 200 OK Code de réponse et un objet de la collection educationSchool dans le corps de la réponse.If successful, this method returns a 200 OK response code and an educationSchool collection object in the response body.

Important

les deltas educationSchool n’incluent pas les écoles supprimées.educationSchool deltas do not include deleted schools.

ExempleExample

L’exemple ci-après montre comment appeler cette API.The following example shows how to call this API.

DemandeRequest

Voici un exemple de demande.The following is an example of the request.

GET https://graph.microsoft.com/beta/education/schools/delta

RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de lisibilité. Toutes les propriétés sont renvoyées à partir d’un appel réel.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

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

{
  "value": [
    {
      "address": { "@odata.type": "microsoft.graph.physicalAddress" },
      "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
      "description": "String",
      "displayName": "String",
      "externalId": "String",
      "externalPrincipalId": "String",
      "externalSource": "string",
      "highestGrade": "String",
      "id": "String (identifier)",
      "lowestGrade": "String",
      "phone": "String",
      "principalEmail": "String",
      "principalName": "String",
      "schoolNumber": "String"
    }
  ]
}