Esta página contém informações sobre os próximos recursos da API Classroom e detalhes sobre como participar da prévia para desenvolvedores.
Visualizar a API Classroom
A visualização dos recursos da API Classroom oferece uma oportunidade para os desenvolvedores influenciarem a forma de desenvolvimento de recursos com feedback e ter integrações prontas para uso público antes da disponibilidade geral.
Ciclo de vida da visualização
Os desenvolvedores podem ativar versões da API que contêm novos recursos compatíveis com versões anteriores. Essas "versões de pré-lançamento" ficam disponíveis publicamente por pelo menos 90 dias. Sujeito a feedback, a versão de pré-lançamento e os recursos dela são incorporados à API v1 atual. As versões de pré-lançamento permanecem disponíveis por pelo menos mais 90 dias antes de serem desativadas.
Se o feedback sobre uma versão de visualização for forte o suficiente para exigir mudanças interruptivas, uma nova versão será criada para oferecer suporte aos recursos atuais. Ambas as versões estão disponíveis por pelo menos 90 dias para permitir a migração do desenvolvedor. Participe da lista de e-mails da prévia para desenvolvedores da API Classroom e fique por dentro das mudanças da prévia. Inscreva-se na lista de avisos para receber atualizações mais gerais da API Classroom.
Participar das prévias da API Classroom
Para participar, inscreva-se no Programa de prévia para desenvolvedores do Google Workspace. Os recursos disponíveis de Acesso antecipado público estão listados nas prévias ativas para desenvolvedores do Google Workspace. Se você estiver testando um recurso de pré-lançamento privado, talvez ele não seja listado em nenhuma documentação pública.
Próximos recursos
Este é nosso cronograma de recursos esperados da API e as respectivas linhas do tempo. Ele é atualizado periodicamente.
O valor da versão de pré-lançamento representa a data esperada para a disponibilidade inicial da versão. Consulte Acessar APIs de pré-lançamento para saber como as versões de pré-lançamento são usadas.
| Recurso | Descrição | Destino para visualização | Meta para o GA | Versão da pré-visualização |
|---|---|---|---|---|
| Períodos de avaliação | Criar, ler, atualizar e excluir períodos de avaliação em nome de administradores e professores. | 1º semestre de 2024 | TBD |
V1_20240401_PREVIEW |
| Recursos do usuário | Confira se um usuário tem acesso a determinados recursos do Google Sala de Aula. | 4º trimestre de 2024 | 1º semestre de 2025 | V1_20240930_PREVIEW |
Versões anteriores
Depois que os novos recursos são validados, eles são incorporados à API v1 e a versão de pré-lançamento correspondente é encerrada. Os desenvolvedores têm pelo menos 90 dias para migrar antes que a versão de pré-lançamento seja desativada.
| Recurso | Descrição | Incorporado ao GA | Data de desativação da visualização desejada | Versão da pré-visualização |
|---|---|---|---|---|
| CRUD de rubricas | Criar, ler, atualizar e excluir rubricas em nome dos professores. | 5 de dezembro de 2024 | 1 de abril de 2025 | V1_20231110_PREVIEW |
Orientações sobre migração
Depois que os recursos de uma versão de visualização forem incorporados à API v1, remova
o argumento previewVersion das chamadas de API relacionadas para garantir que o
aplicativo continue se comportando como esperado. Por exemplo, se você estivesse acessando
os recursos de criação de rubricas introduzidos na versão V1_20231110_PREVIEW,
suas chamadas de API poderiam ter a seguinte aparência:
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 para a API v1 do GA, remova o argumento previewVersion:
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
Se você estava usando uma biblioteca de cliente gerada estaticamente especificamente para acessar um determinado recurso da versão de pré-lançamento e não está usando outros recursos da API de pré-lançamento, faça a transição para a biblioteca de cliente padrão do seu idioma. Consulte Acessar APIs de visualização para saber mais.
Feedback
Compartilhe seu feedback sobre os recursos de prévia usando o IssueTracker vinculado na seção prévias ativas para desenvolvedores da página de visão geral do Programa de prévia para desenvolvedores do Google Workspace.
Usar os recursos de pré-lançamento da API Classroom na produção
Se você quiser usar os recursos de visualização da API Classroom com usuários finais, incluindo professores, administradores ou estudantes reais, concorde com uma emenda específica do Google Sala de Aula aos termos do programa de prévia para desenvolvedores do Google Workspace. Para isso, preencha e envie este formulário: