Questa pagina contiene informazioni sulle funzionalità in arrivo per l'API Classroom e dettagli su come partecipare all'anteprima per gli 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 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 poi incorporate nell'API v1 esistente. Le versioni di anteprima rimarranno disponibili per almeno altri 90 giorni prima di essere chiuse.
Se il feedback su una versione di anteprima è sufficiente a richiedere modifiche che provocano errori, 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 Anteprima per sviluppatori dell'API Classroom per rimanere aggiornato sulle modifiche dell'anteprima e iscriviti alla mailing list degli annunci per ricevere aggiornamenti più generali sull'API Classroom.
Partecipare alle anteprime dell'API Classroom
Per partecipare, unisciti al programma Anteprima per sviluppatori di Google Workspace. Le funzionalità di anteprima pubblica disponibili sono elencate nelle anteprime attive per sviluppatori di Google Workspace. Se stai testando una funzionalità di anteprima privata, potresti non vederla elencata in alcuna documentazione pubblica.
Funzionalità in arrivo
Questa è la nostra roadmap delle funzionalità API previste e delle relative tempistiche. Viene aggiornato periodicamente.
Il valore della versione di anteprima rappresenta la data prevista per la disponibilità iniziale dell'anteprima della versione. Consulta la sezione Accedere alle API di anteprima per scoprire come vengono utilizzate le versioni di anteprima.
| Funzionalità | Descrizione | Target per l'anteprima | Target per GA | Preview Version |
|---|---|---|---|---|
| Funzionalità utente | Controllare se un utente ha accesso a determinate funzionalità di Classroom. | 2024 Q4 | 1° semestre 2025 | V1_20240930_PREVIEW |
| Gruppi di studenti | Gestisci i gruppi di studenti e i relativi membri per conto di amministratori e insegnanti. | T3 2025 | Da definire | V1_20250630_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 | Incorporato in GA | Data di chiusura dell'anteprima target | Preview Version |
|---|---|---|---|---|
| CRUD delle rubriche | Creare, leggere, aggiornare ed eliminare le rubriche di Classroom per conto degli insegnanti. | 2024 Dicembre 05 | 1° aprile 2025 | V1_20231110_PREVIEW |
| Periodi di valutazione | Creare, leggere, aggiornare ed eliminare i periodi di valutazione per conto di amministratori e insegnanti. | 2025 Apr 8 | 1° agosto 2025 | V1_20240401_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 la tua
applicazione continui a funzionare come previsto. Ad esempio, se accedevi
alle funzionalità di creazione di rubriche introdotte nella versione V1_20231110_PREVIEW,
le tue chiamate API potrebbero essere state le 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 appositamente 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à di anteprima tramite IssueTracker collegato nella sezione Anteprime per sviluppatori attive della pagina di panoramica del programma Google Workspace Developer Preview.
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 un emendamento specifico per Classroom ai termini del programma di anteprima per sviluppatori di Google Workspace completando e inviando questo modulo: