Questa pagina contiene informazioni sulle funzionalità in arrivo per l'API Classroom e dettagli su come partecipare all'anteprima per sviluppatori.
Visualizzare l'anteprima dell'API Classroom
L'anteprima delle funzionalità dell'API Classroom offre agli sviluppatori l'opportunità di influenzare lo sviluppo delle funzionalità con il loro feedback e di preparare le integrazioni per l'uso pubblico prima della disponibilità generale.
Ciclo di vita dell'anteprima
Gli sviluppatori possono attivare le versioni dell'API che contengono nuove funzionalità retrocompatibili. Queste "versioni di anteprima" sono disponibili pubblicamente per almeno 90 giorni. In base al feedback, la versione di anteprima e le relative funzionalità vengono incorporate nell'API v1 esistente. Le versioni di anteprima rimangono disponibili per almeno altri 90 giorni prima di essere chiuse.
Se il feedback su una versione di anteprima è sufficientemente forte da richiedere modifiche che causano interruzioni, viene creata una nuova versione per supportare le funzionalità esistenti. Entrambe le versioni sono disponibili per almeno 90 giorni per consentire la migrazione degli sviluppatori. Iscriviti alla mailing list dell'anteprima per sviluppatori dell'API Classroom per rimanere aggiornato sulle modifiche dell'anteprima e alla lista di annunci per aggiornamenti più generali dell'API Classroom .
Partecipare alle anteprime dell'API Classroom
Per partecipare, iscriviti al programma Anteprima per gli sviluppatori di Google Workspace. Le funzionalità di anteprima pubblica disponibili sono elencate in nelle anteprime per sviluppatori attive di Google Workspace. Se stai testando una funzionalità di anteprima privata, potresti non vederla elencata in nessuna documentazione pubblica.
Funzionalità in arrivo
Questa è la nostra roadmap delle funzionalità API previste e delle relative tempistiche. Viene aggiornata periodicamente.
Il valore della versione di anteprima rappresenta la data prevista per la disponibilità iniziale dell'anteprima della versione. Consulta Accedere alle API di anteprima per scoprire come vengono utilizzate le versioni di anteprima.
| Funzionalità | Descrizione | Obiettivo per l'anteprima | Obiettivo per la disponibilità generale | Versione di anteprima |
|---|---|---|---|---|
| Funzionalità utente | Verifica se un utente ha accesso a determinate funzionalità di Classroom. | Q4 2024 | H1 2025 | V1_20240930_PREVIEW |
| Obiettivi di apprendimento | Imposta gli standard di apprendimento sui corsi e gli obiettivi di apprendimento su CourseWork e Rubriche. | Q3 2026 | Q4 2026 | V1_20260316_PREVIEW |
Versioni precedenti
Una volta convalidate le nuove funzionalità, queste vengono incorporate nell'API v1 e la versione di anteprima corrispondente viene chiusa. Gli sviluppatori hanno almeno 90 giorni per eseguire la migrazione prima della chiusura della versione di anteprima.
| Funzionalità | Descrizione | Incorporata nella disponibilità generale | Data di disattivazione dell'anteprima di destinazione | Versione di anteprima |
|---|---|---|---|---|
| CRUD delle rubriche | Crea, leggi, aggiorna ed elimina le rubriche di Classroom per conto degli insegnanti. | 5 dicembre 2024 | 1° aprile 2025 | V1_20231110_PREVIEW |
| Periodi di valutazione | Crea, leggi, aggiorna ed elimina i periodi di valutazione per conto di amministratori e insegnanti. | 8 aprile 2025 | 1° agosto 2025 | V1_20240401_PREVIEW |
| Gruppi di studenti | Gestisci i gruppi di studenti e i relativi membri per conto di amministratori e insegnanti. | 26 gennaio 2026 | 1° giugno 2026 | V1_20250630_PREVIEW |
Indicazioni per la migrazione
Una volta che le funzionalità di una versione di anteprima sono incorporate nell'API v1, rimuovi l'argomento previewVersion dalle chiamate API correlate per assicurarti che l'applicazione continui a comportarsi come previsto. Ad esempio, se accedevi alle funzionalità di creazione delle rubriche introdotte nella versione V1_20231110_PREVIEW, le chiamate API potrebbero essere simili alle seguenti:
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()
Per eseguire la migrazione all'API v1 GA, rimuovi l'argomento previewVersion:
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
Se utilizzavi una libreria client generata staticamente specificamente per accedere a una determinata funzionalità della versione di anteprima e non utilizzi altre funzionalità dell'API di anteprima, esegui la transizione alla libreria client predefinita per la tua lingua. Per saperne di più, consulta Accedere alle API di anteprima.
Feedback
Condividi il tuo feedback sulle funzionalità in anteprima tramite IssueTracker collegato nella sezione delle anteprime per gli sviluppatori attive della pagina di panoramica del programma Anteprima per gli sviluppatori di Google Workspace.
Utilizzare le funzionalità di anteprima dell'API Classroom in produzione
Se vuoi utilizzare le funzionalità di anteprima dell'API Classroom con gli utenti finali, inclusi insegnanti, amministratori o studenti reali, devi accettare una modifica specifica di Classroom ai termini del programma Anteprima per sviluppatori di Google Workspace di Google Workspace compilando e inviando questo modulo: