Questa pagina contiene informazioni sulle funzionalità future dell'API Classroom e dettagli su come partecipare alla preview per sviluppatori.
Prova l'API Classroom
La visualizzazione in anteprima delle funzionalità dell'API Classroom offre agli sviluppatori l'opportunità di influenzare la forma dello sviluppo delle funzionalità con feedback e di avere le integrazioni pronte 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à compatibili con le versioni precedenti. 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 significativo da richiedere modifiche che comportano 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 Anteprima per sviluppatori dell'API Classroom per ricevere aggiornamenti sulle modifiche dell'anteprima e alla mailing list degli annunci per aggiornamenti più generali sull'API Classroom.
Partecipare alle anteprime dell'API Classroom
Per partecipare, iscriviti al programma Developer Preview di Google Workspace. Le funzionalità di Anteprima pubblica disponibili sono elencate nelle anteprime per sviluppatori attive di Google Workspace. Se stai testando una funzionalità di anteprima privata, potresti non trovarla elencata nella documentazione pubblica.
Funzionalità in arrivo
Questa è la nostra roadmap delle funzionalità dell'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 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 |
|---|---|---|---|---|
| Periodi di valutazione | Crea, leggi, aggiorna ed elimina i periodi di valutazione per conto di amministratori e insegnanti. | 1° semestre 2024 | TBD |
V1_20240401_PREVIEW |
| Funzionalità utente | Verificare se un utente ha accesso a determinate funzionalità di Classroom. | 4° trimestre 2024 | 1ª metà 2025 | V1_20240930_PREVIEW |
Versioni precedenti
Una volta convalidate, le nuove funzionalità vengono incorporate nell'API v1 e la versione di anteprima corrispondente viene chiusa. Gli sviluppatori hanno almeno 90 giorni di tempo per eseguire la migrazione prima della chiusura della versione di anteprima.
| Funzionalità | Descrizione | Incorporato in GA | Data di chiusura dell'anteprima target | Preview Version |
|---|---|---|---|---|
| Rubric CRUD | Creare, leggere, aggiornare ed eliminare le rubriche di Classroom per conto degli insegnanti. | 05 dic 2024 | 1° apr 2025 | V1_20231110_PREVIEW |
Informazioni sulla migrazione
Una volta incorporate le funzionalità di una versione di anteprima nell'API v1, rimuovi
l'argomento previewVersion dalle chiamate API correlate per assicurarti che la tua
applicazione continui a comportarsi come previsto. Ad esempio, se avevi accesso alle funzionalità di creazione delle rubriche introdotte nella versione V1_20231110_PREVIEW, le chiamate all'API potrebbero avere il seguente aspetto:
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 GA v1, 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 in modo statico specificamente per accedere a una determinata funzionalità della versione di anteprima e non utilizzi altre funzionalità dell'API di anteprima, passa 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 Panoramica del programma Anteprima per 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 un emendamento specifico per Classroom ai Termini del programma di anteprima per gli sviluppatori di Google Workspace compilando e inviando questo modulo: