En esta página, se incluye información sobre las próximas funciones de la API de Classroom y detalles para participar en la versión preliminar para desarrolladores.
Obtén una vista previa de la API de Classroom
La vista previa de las funciones de la API de Classroom brinda a los desarrolladores la oportunidad de influir en el desarrollo de funciones con comentarios y tener integraciones listas para el uso público antes de la disponibilidad general.
Ciclo de vida de la versión preliminar
Los desarrolladores pueden habilitar las versiones de la API que contienen funciones nuevas y retrocompatibles. Estas "versiones preliminares" están disponibles públicamente durante al menos 90 días. Según los comentarios, la versión preliminar y sus funciones se incorporan a la API de la versión 1 existente. Las versiones preliminares permanecen disponibles durante al menos otros 90 días antes de cerrarse.
Si los comentarios sobre una versión preliminar son lo suficientemente sólidos como para requerir cambios rotundos, se crea una versión nueva para admitir las capacidades existentes. Ambas versiones están disponibles durante al menos 90 días para permitir la migración de desarrolladores. Únete a la lista de distribución de la versión preliminar para desarrolladores de la API de Classroompara mantenerte informado sobre los cambios en la versión preliminar y suscríbete a la lista de anuncios para obtener más actualizaciones generales de la API de Classroom.
Participa en las versiones preliminares de la API de Classroom
Para participar, únete al Programa de Versión preliminar para desarrolladores de Google Workspace Developer Preview Program. Las funciones de versión preliminar pública disponibles se enumeran en las versiones preliminares para desarrolladores activas de Google Workspace. Si estás probando una función de versión preliminar privada, es posible que no veas esa función en ninguna documentación pública.
Próximas funciones
Este es nuestro plan de trabajo de las funciones de la API esperadas y sus cronogramas. Se actualiza periódicamente.
El valor de la versión preliminar representa la fecha esperada para la disponibilidad inicial de la versión preliminar. Consulta Accede a las APIs de versión preliminar para obtener información sobre cómo se usan las versiones preliminares.
| Función | Descripción | Objetivo para la versión preliminar | Objetivo para la DG | Versión de la vista previa |
|---|---|---|---|---|
| Capacidades del usuario | Verifica si un usuario tiene acceso a ciertas funciones de Classroom. | Cuarto trimestre de 2024 | Primer semestre de 2025 | V1_20240930_PREVIEW |
| Objetivos de aprendizaje | Establece estándares de aprendizaje en los cursos y objetivos de aprendizaje en CourseWork y Rúbricas. | Tercer trimestre de 2026 | Cuarto trimestre de 2026 | V1_20260316_PREVIEW |
Versiones anteriores
Una vez que se validan las funciones nuevas, se incorporan a la API de la versión 1 y se cierra la versión preliminar correspondiente. Los desarrolladores tienen al menos 90 días para migrar antes de que se cierre la versión preliminar.
| Función | Descripción | Incorporado a la DG | Fecha de cierre de la versión preliminar objetivo | Versión de la vista previa |
|---|---|---|---|---|
| CRUD de rúbricas | Crea, lee, actualiza y borra rúbricas de Classroom en nombre de los profesores. | 5 de diciembre de 2024 | 1 de abril de 2025 | V1_20231110_PREVIEW |
| Períodos de calificación | Crea, lee, actualiza y borra períodos de calificación en nombre de los administradores y profesores. | 8 de abril de 2025 | 1 de agosto de 2025 | V1_20240401_PREVIEW |
| Grupos de estudiantes | Administra los grupos de estudiantes y sus miembros en nombre de los administradores y profesores. | 26 de enero de 2026 | 1 de junio de 2026 | V1_20250630_PREVIEW |
Guía de migración
Una vez que las funciones de una versión preliminar se incorporan a la API de la versión 1, quita el argumento previewVersion de las llamadas a la API relacionadas para asegurarte de que tu aplicación siga comportándose como se espera. Por ejemplo, si accedías a las capacidades de creación de rúbricas introducidas en la versión V1_20231110_PREVIEW, es posible que tus llamadas a la API se vieran de la siguiente manera:
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()
Para migrar a la API de la versión 1 de DG, quita el argumento previewVersion:
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
Si usabas una biblioteca cliente generada de forma estática específicamente para acceder a una función de versión preliminar determinada y no usas otras funciones de la API de versión preliminar, realiza la transición a la biblioteca cliente predeterminada para tu lenguaje. Consulta Accede a las APIs de versión preliminar para obtener más información.
Comentarios
Comparte tus comentarios sobre las funciones de versión preliminar a través del IssueTracker vinculado en la sección de versiones preliminares para desarrolladores activas de la página de descripción general del Programa de Versión preliminar para desarrolladores de Google Workspace.
Usa las funciones de versión preliminar de la API de Classroom en producción
Si deseas usar las funciones de versión preliminar de la API de Classroom con usuarios finales, incluidos profesores, administradores o estudiantes reales, debes aceptar una enmienda específica de Classroom a las condiciones del Programa de Versión preliminar para desarrolladores de Google Workspace Google Workspace Developer Preview Program terms completando y enviando este formulario: