Recursos da prévia e roteiro

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.

Prévia da API Classroom

A prévia dos recursos da API Classroom oferece aos desenvolvedores a oportunidade de influenciar o desenvolvimento de recursos com feedback e ter integrações prontas para uso público antes da disponibilidade geral.

Ciclo de vida da prévia

Os desenvolvedores podem ativar versões da API que contêm recursos novos e compatíveis com versões anteriores. Essas "versões de prévia" estão disponíveis publicamente por pelo menos 90 dias. Sujeita a feedback, a versão de prévia e os recursos dela são incorporados à API v1 atual. As versões de prévia permanecem disponíveis por pelo menos mais 90 dias antes de serem desativadas.

Se o feedback sobre uma versão de prévia for forte o suficiente para exigir mudanças interruptivas, uma nova versão será criada para oferecer suporte aos recursos atuais. As duas versões ficam 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 Classroompara ficar informado sobre as mudanças na prévia e inscreva-se na lista de anúncios 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 Developer Preview Program. Os recursos de prévia pública disponíveis estão listados em nas prévias ativas para desenvolvedores do Google Workspace . Se você estiver testando um recurso de prévia privada, ele não será listado em nenhuma documentação pública.

Próximos recursos

Este é nosso roteiro de recursos esperados da API e os cronogramas deles. Ele é atualizado periodicamente.

O valor da versão de prévia representa a data esperada para a disponibilidade inicial da versão. Consulte Acessar APIs de prévia para saber como as versões de prévia são usadas.

Versões anteriores

Depois que os novos recursos são validados, eles são incorporados à API v1 e a versão de prévia correspondente é desativada. Os desenvolvedores têm pelo menos 90 dias para migrar antes que a versão de prévia seja desativada.

Orientações sobre a Migração

Depois que os recursos de uma versão de prévia 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ê estava acessando os recursos de criação de rubricas introduzidos na versão V1_20231110_PREVIEW, as chamadas de API podem ter sido assim:

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 GA, remova o argumento previewVersion:

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        ).execute()

Se você estiver usando uma biblioteca de cliente gerada estaticamente especificamente para acessar um determinado recurso de versão de prévia e não estiver usando outros recursos de API de prévia, faça a transição para a biblioteca de cliente padrão do seu idioma. Consulte Acessar APIs de prévia para saber mais.

Feedback

Compartilhe seu feedback sobre os recursos de prévia pelo IssueTracker vinculado na seção de prévias ativas para desenvolvedores da página de visão geral do Programa de prévia para desenvolvedores do Google Workspace.

Usar recursos de prévia da API Classroom na produção

Se você quiser usar os recursos de prévia da API Classroom com usuários finais, incluindo professores, administradores ou estudantes reais, aceite uma modificação específica do Google Sala de Aula nos Termos do Google Workspace Google Workspace Programa de prévia para desenvolvedores preenchendo e enviando este formulário: