Création d’un objet educationClass

Espace de noms: microsoft.graph

Important

Les API sous /beta la version dans Microsoft Graph sont sujettes à modification. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version.

Créez un cours. Cela créera également un groupe universel. Lorsque vous utilisez cette API pour créer une classe, elle ajoute des propriétés spéciales au groupe, ce qui ajoute des fonctionnalités telles que des affectations et une gestion spéciale au sein de Microsoft Teams lorsque des équipes sont créées à l’aide du groupe. Notez que cette API crée uniquement le groupe universel et ne crée pas d’équipe. Microsoft Teams fournit une interface utilisateur permettant aux enseignants de créer des équipes pour leurs propres classes à l’aide des groupes créés par cette API.

Autorisations

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.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge.
Application EduRoster.ReadWrite.All

Requête HTTP

POST /education/classes

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire.
Content-Type application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON d’un objet educationClass.

Réponse

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

Exemple

Demande

Voici un exemple de demande.

POST https://graph.microsoft.com/beta/education/classes
Content-type: application/json

{
  "description": "Health Level 1",
  "classCode": "Health 501",
  "displayName": "Health 1",
  "externalId": "11019",
  "externalName": "Health Level 1",
  "externalSource": "sis",
  "mailNickname": "fineartschool.net"
}
Réponse

Voici un exemple de 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

{
    "id": "11019",
    "description": "Health Level 1",
    "classCode": "Health 501",
    "createdBy": {
      "user": {
        "displayName": "Susana Rocha",
        "id": "14012",
      }
    },
    "displayName": "Health 1",
    "externalId": "11019",
    "externalName": "Health Level 1",
    "externalSource": "sis",
    "mailNickname": "fineartschool.net"
}