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.

Conheça a API Classroom

O pré-lançamento 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 há 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 vão ficar 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. Ambas as versões ficam disponíveis por pelo menos 90 dias para permitir a migração do desenvolvedor. Inscreva-se na lista de e-mails da prévia para desenvolvedores da API Classroom para ficar por dentro das mudanças na prévia e 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. Os recursos disponíveis na prévia pública estão listados nas prévias ativas para desenvolvedores do Google Workspace. Se você estiver testando um recurso de prévia particular, talvez ele não apareça em nenhuma documentação pública.

Próximos recursos

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

O valor da versão de pré-lançamento representa a data esperada para a disponibilidade inicial de pré-lançamento da versão. Consulte Acessar APIs de pré-lançamento para saber como as versões de pré-lançamento 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ção de 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 funcionando conforme o esperado. Por exemplo, se você estivesse acessando recursos de criação de rubricas introduzidos na versão V1_20231110_PREVIEW, suas chamadas de API poderiam ter esta 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 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 recurso de uma determinada versão de prévia e não estiver usando outros recursos da API de prévia, faça a transição para a biblioteca de cliente padrão da sua linguagem. Consulte Acessar APIs de prévia para saber mais.

Feedback

Compartilhe seu feedback sobre os recursos de prévia usando o IssueTracker vinculado na seção Prévia para desenvolvedores ativa 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 em produção

Se você quiser usar os recursos de prévia da API Classroom com usuários finais, incluindo professores, administradores ou estudantes reais, concorde com uma alteração específica do Classroom nos termos do Programa de prévia para desenvolvedores do Google Workspace. Para isso, preencha e envie este formulário: