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.
Vista previa de la API de Classroom
La versión preliminar de las funciones de la API de Classroom brinda a los desarrolladores la oportunidad de influir en el desarrollo de las funciones con sus comentarios y tener las 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. Sujeta a los comentarios, la versión preliminar y sus funciones se incorporan a la API v1 existente. Las versiones preliminares seguirá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 nueva versión para admitir las capacidades 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 en la versión preliminar y suscríbete a la lista de anuncios para obtener 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 disponibles en la versión preliminar pública se enumeran en las versiones preliminares activas para desarrolladores de Google Workspace. Si estás probando una función de versión preliminar privada, es posible que no la veas en la 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 periódicamente.
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 en versión preliminar para obtener información sobre cómo se usan las versiones preliminares.
| Función | Descripción | Objetivo de la vista previa | Objetivo de la DG | Versión de la vista previa |
|---|---|---|---|---|
| Capacidades del usuario | Verifica si un usuario tiene acceso a ciertas funciones de Classroom. | 4º trim. del 2024 | 1ᵉʳ semestre de 2025 | V1_20240930_PREVIEW |
| Grupos estudiantiles | Administrar grupos de estudiantes y sus miembros en nombre de administradores y profesores | 3ᵉʳ trim. de 2025 | Por definir | V1_20250630_PREVIEW |
Versiones anteriores
Una vez que se validan las funciones nuevas, se incorporan a la API de v1 y se cierra la versión preliminar correspondiente. Los desarrolladores tienen, al menos, 90 días para realizar la migración antes de que se cierre la versión preliminar.
| Función | Descripción | Se incorporó a DG | Fecha objetivo de cierre de la vista previa | Versión de la vista previa |
|---|---|---|---|---|
| CRUD de rúbricas | Crear, leer, actualizar y borrar rúbricas de Classroom en nombre de los profesores | 5 de diciembre de 2024 | 2025, 1 de abril | V1_20231110_PREVIEW |
| Períodos de calificación | Crear, leer, actualizar y borrar 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 |
Orientación para la 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 funcionando según lo esperado. Por ejemplo, si accedieras a las capacidades de creación de rúbricas introducidas en la versión V1_20231110_PREVIEW, tus llamadas a la API podrían verse 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 de 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 en versión preliminar, realiza la transición a la biblioteca cliente predeterminada para tu lenguaje. Consulta APIs de acceso anticipado para obtener más información.
Comentarios
Comparte tus comentarios sobre las funciones de vista previa a través del 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.
Usar las funciones de versión preliminar de la API de Classroom en producción
Si deseas usar las funciones de la versión preliminar de la API de Classroom con usuarios finales, incluidos los 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 completando y enviando este formulario: