Sitzungen und Sitzungsgruppen per API erstellen

Sie können Kurssitzungen und Sitzungsgruppen über die Learn365-API oder das Learn365 Admin Center erstellen. In diesem Artikel beschreiben wir, wie Sie eine Sitzung oder eine Sitzungsgruppe über die API erstellen.

 

 

Zum Erstellen einer Sitzung oder Sitzungsgruppe benötigen Sie die ID des Kurses, in dessen Rahmen die Sitzung oder Sitzungsgruppe stattfinden wird. Sie finden die Kurs-ID per API, indem Sie die Schritte in diesem Artikel befolgen.

Wenn Sie eine neue Sitzung als Teil einer bestehenden Sitzungsgruppe erstellen möchten, benötigen Sie die ID dieser Gruppe. Sie können diese Information per API ermitteln, indem Sie die Schritte in diesem Artikel befolgen.

So erstellen Sie eine Sitzung oder eine Sitzungsgruppe per API:

1. Gehen Sie zu https://api.365.systems/, und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.

2. Wählen Sie im Abschnitt Courses den Endpunkt POST /odata/v2/Courses({Id})/CourseSessions und klicken Sie oben rechts auf Try it out.

3. Geben Sie in das Pflichtfeld id die ID des Kurses ein, für den Sie eine Sitzung erstellen möchten. Informationen zum Abrufen einer Kurs-ID finden Sie in diesem Artikel.

4. Bei Bedarf können Sie die Antwortdaten filtern, indem Sie die Felder $expand und $select ausfüllen. Informationen darüber, wie diese Filter verwendet werden, finden Sie in diesem Artikel.

5. Geben Sie im courseSession-Objekt die folgenden Pflichtparameter ein:

• Title. Name der neuen Sitzung oder Sitzungsgruppe. Dies kann ein beliebiger Text mit bis zu 128 Zeichen Länge sein.
• GroupId. Wenn Sie möchten, dass eine Sitzung Teil einer Sitzungsgruppe wird, geben Sie die ID der Sitzungsgruppe in das Feld GroupId ein. Informationen zum Ermitteln einer Sitzungsgruppen-ID finden Sie in diesem Artikel.
• StartDate. Geben Sie das Startdatum der Sitzung ein, beispielsweise "2024-06-22T10:30:00.0000000+00:00". Dieser Parameter ist für eine Sitzungsgruppe nicht erforderlich.
• EndDate. Geben Sie das Enddatum der Sitzung ein, beispielsweise "2024-06-22T12:45:00.0000000+00:00". Dieser Parameter ist für eine Sitzungsgruppe nicht erforderlich.
• TimeZone. Geben Sie die Zeitzone für die Start-/Enddaten der Sitzung als Zeichenfolge ein. Beispiel: "UTC". Dieser Parameter ist für eine Sitzungsgruppe nicht erforderlich.
• IsGroup. Wenn Sie eine Sitzungsgruppe erstellen, legen Sie diesen Parameter auf true fest. Der Parameter ist für eine Sitzung nicht erforderlich.

Wenn Sie eine Onlinesitzung in Microsoft Teams erstellen möchten, geben Sie die folgenden Parameter ein:

• IsTeamsOnlineMeeting. Bei einer Onlinesitzung legen Sie diesen Parameter auf true fest.
• MeetingUrl. Geben Sie die URL einer Microsoft Teams-Besprechung ein.

Die Eingabe dieser obligatorischen Parameter ist ausreichend, um eine neue Sitzung oder Sitzungsgruppe zu erstellen. Sie können weitere Informationen hinzufügen, indem Sie die optionalen Parameter eingeben.

6. Wählen Sie Execute aus, um die Anfrage auszuführen.

 

 

7. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren:

• Der Code 201 mit Sitzungs- oder Sitzungsgruppendetails im Antworttext signalisiert eine erfolgreich abgerufene Antwort.
• Im Fehlerfall enthält der Antworttext das Objekt error mit den Schlüsseln code und message, die das Problem erklären.

 

 

Sie können den Audit-Trail einsehen, um weitere Informationen über die erstellte Sitzung oder Sitzungsgruppe zu erhalten.

8. Gehen Sie zu Learn365 Admin Center > Globale Einstellungen > Audit-Trail.

9. Suchen Sie nach dem letzten Datensatz mit dem Aktivitätsnamen Session was created oder Session group was created und wählen Sie ihn aus, um weitere Informationen anzuzeigen.

 

 

Weitere Informationen zu Audit-Trails finden Sie in diesem Artikel.