Educationclass-Eigenschaften aktualisierenUpdate educationclass properties

Namespace: microsoft.graphNamespace: microsoft.graph

Dient zum Aktualisieren der Eigenschaften einer Klasse.Update the properties of a class.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Nicht unterstütztNot supported.
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication EduRoster.ReadWrite.AllEduRoster.ReadWrite.All

HTTP-AnforderungHTTP request

PATCH /education/classes/{id}

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen.In the request body, supply the values for relevant fields that should be updated. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.For best performance, don't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
descriptiondescription StringString Beschreibung der KlasseDescription of the class.
displayNamedisplayName ZeichenfolgeString Der Name der KlasseName of the class.
mailNicknamemailNickname ZeichenfolgeString E-Mail-Alias zum Senden von E-Mails an alle Benutzer, wenn diese Funktion aktiviert ist.Email alias for sending email to all users if that feature is enabled.
classCodeclassCode ZeichenfolgeString Klassencode, der von der Schule verwendet wird.Class code used by the school.
externalIdexternalId ZeichenfolgeString ID der Klasse aus dem SynchronisierungssystemID of the class from the syncing system.
externalNameexternalName StringString Der Name der Klasse im SynchronisierungssystemName of the class in the syncing system.
externalSourceexternalSource stringstring Quelle, aus der diese Klasse erstellt wurde.How this class was created. Die möglichen Werte sind: sis, manual, enum_sentinel.The possible values are: sis, manual, enum_sentinel.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und ein aktualisiertes educationClass-Objekt im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and an updated educationClass object in the response body.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.The following is an example of the request.

PATCH https://graph.microsoft.com/v1.0/education/classes/{class-id}
Content-type: application/json
Content-length: 224

{
  "description": "History - World History 1",
  "displayName": "World History Level 1",
}
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden. Ein tatsächlicher Aufruf gibt alle Eigenschaften zurück.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: 224

{
  "id": "11014",
  "description": "World History Level 1",
  "classCode": "301",
  "createdBy": {
    "user": {
      "displayName": "Susana Rocha",
      "id": "14012"
    }
  },
  "displayName": "History - World History 1",
  "externalId": "301",
  "externalName": "World History Level 1",
  "externalSource": "Fabrikam High School",
  "mailNickname": "Fabrikam"
}