En esta página, encontrarás 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
Obtener una vista previa de las funciones de la API de Classroom brinda a los desarrolladores la oportunidad de influir en la forma en que se desarrollan las 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 versiones de la API que contengan funciones nuevas y compatibles con versiones anteriores. 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 v1 existente. Las versiones preliminares permanecerán disponibles durante al menos otros 90 días antes de que se cierren.
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 funciones existentes. Ambas versiones estarán disponibles durante al menos 90 días para permitir la migración de los desarrolladores. Únete a la lista de distribución de la Versión preliminar para desarrolladores de la API de Classroom para mantenerte al tanto de los cambios de la versión preliminar y suscríbete a la lista de anuncios para recibir actualizaciones más 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. Las funciones de la versión preliminar pública disponibles se enumeran en las versiones preliminares activas para desarrolladores de Google Workspace. Si estás probando una función de vista previa privada, es posible que no la veas en ninguna documentación pública.
Próximas funciones
Esta es nuestra hoja de ruta de las funciones de la API esperadas y sus cronogramas. Se actualiza de forma periódica.
El valor de la versión preliminar representa la fecha esperada para la disponibilidad inicial de la versión preliminar. Consulta Cómo acceder 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 vista previa | Segmentación para Google Analytics | Versión de la vista previa |
|---|---|---|---|---|
| Períodos de calificación | Crear, leer, actualizar y borrar períodos de calificación en nombre de los administradores y profesores | 1ᵉʳ sem. de 2024 | TBD |
V1_20240401_PREVIEW |
| Funciones del usuario | Verifica si un usuario tiene acceso a ciertas funciones de Classroom. | 4ᵉʳ trim. de 2024 | 1ᵉʳ sem. de 2025 | V1_20240930_PREVIEW |
Versiones anteriores
Una vez que se validan las funciones nuevas, estas se incorporan a la API de v1 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 | Se incorporó a GA | Fecha de baja de la vista previa objetivo | Versión de la vista previa |
|---|---|---|---|---|
| CRUD de rúbricas | Crear, leer, actualizar y borrar rúbricas de la clase en nombre de los profesores | 5 de diciembre de 2024 | 1 de abril de 2025 | V1_20231110_PREVIEW |
Orientación para la migración
Una vez que se incorporen las funciones de una versión preliminar a la API de v1, 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 accediste a las funciones de creación de rúbricas que se introdujeron en la versión V1_20231110_PREVIEW, es posible que tus llamadas a la API se hayan visto 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 GA v1, 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 una 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 de tu lenguaje. Consulta Cómo acceder a las APIs de versión preliminar para obtener más información.
Comentarios
Comparte tus comentarios sobre las funciones de la versión preliminar a través de IssueTracker vinculado en la sección versiones preliminares activas para desarrolladores 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. Para ello, completa y envía este formulario: