Vorschau auf Funktionen und Roadmap

Auf dieser Seite finden Sie Informationen zu anstehenden Funktionen für die Classroom API und Details zur Teilnahme an der Entwicklervorschau.

Vorschau der Classroom API

Die Vorschau von Classroom API-Funktionen bietet Entwicklern die Möglichkeit, die Entwicklung von Funktionen durch Feedback zu beeinflussen und Integrationen vor der allgemeinen Verfügbarkeit für die öffentliche Nutzung vorzubereiten.

Lebenszyklus der Vorschau

Entwickler können Versionen der API aktivieren, die neue, abwärtskompatible Funktionen enthalten. Diese „Vorschauversionen“ sind mindestens 90 Tage lang öffentlich verfügbar. Je nach Feedback werden die Vorabversion und ihre Funktionen dann in die vorhandene v1-API aufgenommen. Vorschaueinrichtungen bleiben mindestens weitere 90 Tage verfügbar, bevor sie geschlossen werden.

Wenn das Feedback zu einer Vorabversion so stark ist, dass grundlegende Änderungen erforderlich sind, wird eine neue Version erstellt, um die vorhandenen Funktionen zu unterstützen. Beide Versionen sind mindestens 90 Tage lang verfügbar, damit Entwickler Zeit für die Migration haben. Abonnieren Sie die Mailingliste für die Classroom API-Entwicklervorschau, um über Änderungen in der Vorschau informiert zu werden, und die Ankündigungsliste, um allgemeinere Updates zur Classroom API zu erhalten.

An Classroom API-Vorabversionen teilnehmen

Wenn Sie teilnehmen möchten, melden Sie sich für das Google Workspace-Entwicklervorschauprogramm an. Verfügbare Funktionen in der öffentlichen Vorschau sind in den aktiven Entwicklervorschauen für Google Workspace aufgeführt. Wenn Sie eine Funktion in der privaten Vorabversion testen, ist sie möglicherweise nicht in der öffentlichen Dokumentation aufgeführt.

Geplante Funktionen

Hier finden Sie unseren Fahrplan für erwartete API-Funktionen und deren Zeitpläne. Sie wird regelmäßig aktualisiert.

Der Wert der Vorschauversion gibt das voraussichtliche Datum für die erste Verfügbarkeit der Vorschau der Version an. Weitere Informationen zur Verwendung von Vorabversionen finden Sie unter Auf Preview-APIs zugreifen.

Vorgängerversionen

Sobald neue Funktionen validiert wurden, werden sie in die v1 API aufgenommen und die entsprechende Vorschauversion wird eingestellt. Entwickler haben mindestens 90 Tage Zeit, um die Migration durchzuführen, bevor die Preview-Version eingestellt wird.

Migrationsanleitung

Sobald Funktionen aus einer Vorschauversion in die v1-API aufgenommen wurden, entfernen Sie das previewVersion-Argument aus den zugehörigen API-Aufrufen, damit sich Ihre Anwendung weiterhin wie erwartet verhält. Wenn Sie beispielsweise auf die in Version V1_20231110_PREVIEW eingeführten Funktionen zum Erstellen von Rubriken zugreifen, sehen Ihre API-Aufrufe möglicherweise so aus:

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        # Specify the preview version. Rubrics CRUD capabilities are
        # supported in V1_20231110_PREVIEW and later.
        previewVersion="V1_20231110_PREVIEW"
        ).execute()

Wenn Sie zur v1 GA-API migrieren möchten, entfernen Sie das previewVersion-Argument:

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        ).execute()

Wenn Sie eine statisch generierte Clientbibliothek speziell für den Zugriff auf eine bestimmte Funktion der Vorabversion verwendet haben und keine anderen API-Funktionen der Vorabversion nutzen, wechseln Sie zur Standard-Clientbibliothek für Ihre Sprache. Weitere Informationen finden Sie unter Zugriff auf Preview-APIs.

Feedback

Geben Sie Feedback zu Vorschaufunktionen über den verlinkten IssueTracker im Abschnitt Aktive Entwicklervorschauen auf der Übersichtsseite zum Google Workspace-Entwicklervorschauprogramm.

Vorschaufunktionen der Classroom API in der Produktion verwenden

Wenn Sie die Vorschaufunktionen der Classroom API mit Endnutzern verwenden möchten, einschließlich echter Lehrkräfte, Administratoren oder Schüler/Studenten, müssen Sie eine Classroom-spezifische Änderung der Nutzungsbedingungen für das Google Workspace-Entwicklervorschauprogramm akzeptieren. Füllen Sie dazu dieses Formular aus und senden Sie es ab: