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 von Funktionen durch 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, 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-Vorabversion für Entwickler an, um über Änderungen an der Vorabversion informiert zu bleiben. Abonnieren Sie die Ankündigungsliste, um allgemeinere Updates zur Classroom API zu erhalten.
An der Vorabversion der Classroom API teilnehmen
Wenn Sie daran teilnehmen möchten, müssen Sie am Google Workspace-Entwicklervorschauprogramm 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 an, an dem die Vorabversion der Version verfügbar sein wird. Informationen zum Zugriff auf Vorabversionen von APIs
| Funktion | Beschreibung | Ziel für die Vorschau | Ziel für Google Analytics | Preview Version |
|---|---|---|---|---|
| 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 |
| Benotungszeiträume | Benotungszeiträume im Namen von Administratoren und Lehrkräften erstellen, lesen, aktualisieren und löschen. | 8. April 2025 | 1. August 2025 | V1_20240401_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 Vorschaufunktionen über den verlinkten IssueTracker im Abschnitt Aktive Entwicklervorschauen auf der Übersichtsseite des Google Workspace-Entwicklervorschauprogramms ein.
Vorabversionen 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: