Auf dieser Seite finden Sie Informationen zu anstehenden Funktionen für die Classroom API und Details dazu, wie Sie an der Entwicklervorschau teilnehmen können.
Classroom API in der Vorabversion testen
Die Vorabversion der Classroom API-Funktionen bietet Entwicklern die Möglichkeit, die Entwicklung der Funktionen mit Feedback zu beeinflussen und Integrationen vor der allgemeinen Verfügbarkeit für die öffentliche Nutzung bereitstellen zu lassen.
Vorschau – Lebenszyklus
Entwickler können Versionen der API aktivieren, die neue, abwärtskompatible Funktionen enthalten. Diese „Vorabversionen“ sind mindestens 90 Tage lang öffentlich verfügbar. Je nach Feedback werden die Vorabversion und ihre Funktionen dann in die vorhandene v1 API übernommen. Vorabversionen sind noch mindestens 90 Tage lang verfügbar, bevor sie eingestellt werden.
Wenn das Feedback zu einer Vorabversion so aussagekräftig ist, dass Änderungen erforderlich sind, die die Kompatibilität beeinträchtigen, wird eine neue Version erstellt, die die vorhandenen Funktionen unterstützt. Beide Versionen sind mindestens 90 Tage lang verfügbar, damit Entwickler die Migration vornehmen können. Melden Sie sich für die Classroom API-Entwicklervorschau an, um über Änderungen an der Vorabversion informiert zu bleiben. Die Ankündigungsliste enthält allgemeinere Updates zur Classroom API.
An der Vorabversion der Classroom API teilnehmen
Wenn Sie daran teilnehmen möchten, müssen Sie am Google Workspace-Vorabprogramm für Entwickler teilnehmen. Verfügbare Funktionen in der öffentlichen Vorschau sind in den aktiven Entwicklervorschauen von Google Workspace aufgeführt. Wenn Sie eine private Vorschaufunktion testen, wird diese Funktion möglicherweise in keiner öffentlichen Dokumentation aufgeführt.
Geplante Funktionen
Hier finden Sie eine Roadmap mit den erwarteten API-Funktionen und ihren Zeitplänen. Sie wird regelmäßig aktualisiert.
Der Wert für die Vorabversion gibt das voraussichtliche Datum für die erste Verfügbarkeit der Vorabversion an. Informationen zum Zugriff auf Vorabversionen von APIs
| Funktion | Beschreibung | Ziel für die Vorschau | Ziel für GA | Preview Version |
|---|---|---|---|---|
| Benotungszeiträume | Benotungszeiträume im Namen von Administratoren und Lehrkräften erstellen, lesen, aktualisieren und löschen | 1. Hj. 2024 | TBD |
V1_20240401_PREVIEW |
| Nutzerfunktionen | Prüfen, ob ein Nutzer Zugriff auf bestimmte Classroom-Funktionen hat | 4. Quartal 2024 | 1. Hälfte 2025 | V1_20240930_PREVIEW |
Vorgängerversionen
Sobald neue Funktionen validiert wurden, werden sie in die v1 API aufgenommen und die entsprechende Vorabversion wird eingestellt. Entwickler haben mindestens 90 Tage Zeit für die Migration, bevor die Vorabversion eingestellt wird.
| Funktion | Beschreibung | In Google Analytics integriert | Datum der Einstellung der Target-Vorschau | Preview Version |
|---|---|---|---|---|
| CRUD-Vorgänge für Bewertungsschemata | Benotungsraster in Classroom im Namen von Lehrkräften erstellen, lesen, aktualisieren und löschen. | 5. Dezember 2024 | 1. April 2025 | V1_20231110_PREVIEW |
Migrationsanleitung
Sobald Funktionen aus einer Vorabversion in die v1 API übernommen wurden, entfernen Sie das Argument previewVersion aus den zugehörigen API-Aufrufen, damit sich Ihre Anwendung weiterhin wie erwartet verhält. Wenn Sie beispielsweise auf die Funktionen zum Erstellen von Rubriken zugegriffen haben, die in der Version V1_20231110_PREVIEW eingeführt wurden, sahen 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 GA4 API v1 migrieren möchten, entfernen Sie das Argument previewVersion:
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 verwenden, wechseln Sie zur Standardclientbibliothek für Ihre Sprache. Weitere Informationen finden Sie unter Vorabzugriff auf APIs.
Feedback
Geben Sie Ihr Feedback zu Vorabversionsfunktionen über den verlinkten IssueTracker im Bereich Aktive Entwicklervorschauen auf der Übersichtsseite des Google Workspace-Entwicklerprogramms für Vorabversionen ein.
Vorschau-Features der Classroom API in der Produktion verwenden
Wenn Sie die Vorabversion der Classroom API mit Endnutzern verwenden möchten, einschließlich echter Lehrkräfte, Administratoren oder Schüler/Studenten, müssen Sie einer Classroom-spezifischen Änderung der Google Workspace-Nutzungsbedingungen für das Entwickler-Vorabprogramm zustimmen. Füllen Sie dazu dieses Formular aus und reichen Sie es ein: