Versão 1.1, 5 de dezembro de 2024.
Os critérios desta página se aplicam a todos os complementos do Google Sala de Aula. Seu complemento precisa atender a todos os itens obrigatórios aplicáveis para ser aprovado para listagem no Google Workspace Marketplace e ser um complemento que "funciona com o Google Sala de Aula".
As palavras-chave "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" e "OPTIONAL" no original deste documento devem ser interpretadas conforme descrito em RFC 2119 (em inglês).
Requisitos
| ID | Tipo | ||
|---|---|---|---|
| 1.0 | Licença de usuário final (se aplicável) | ||
| 1.1 | Uma mensagem fácil de entender DEVE ser mostrada ao usuário quando ele não tiver uma licença. A mensagem DEVE indicar claramente o motivo pelo qual o complemento não pode ser usado e sugerir um curso de ação para o usuário corrigir a situação. | RECOMENDADOS | |
| 1.3 | A listagem do complemento no Google Workspace Marketplace DEVE especificar detalhes sobre os requisitos de licença e assinatura que podem ser necessários para usar o complemento. Se o complemento tiver um nível pago, a listagem do Marketplace DEVE fornecer um link para uma página da Web que ofereça mais informações sobre preços ou como entrar em contato com um vendedor. | RECOMENDADOS | |
| 2.0 | Login do usuário final | ||
| 2.1 | Os usuáriosprofessores PRECISAM fazer login no complemento usando o SSO do Google.Se os estudantes precisarem fazer login no complemento, eles PRECISAM fazer login usando o SSO do Google. |
OBRIGATÓRIO | |
| 2.2 | O complemento PRECISA usar o SSO do Google para fazer login automático de um usuário em visitas subsequentes sem mostrar uma solicitação de login. Quando a dica de login não produzir uma correspondência com o usuário conectado no momento, o complemento PRECISA solicitar ao usuário um botão de login e transmitir o login_hint para a biblioteca de autenticação para filtrar contas inválidas. |
OBRIGATÓRIO | |
| 2.7 | Quando o usuário do Google Sala de Aula ainda não tiver feito login no complemento (conforme determinado pela dica de login), o complemento PRECISA apresentar um botão "Fazer login com o Google" para que o usuário acione explicitamente o processo de login. Observação: isso é necessário para atender às diretrizes de marca do Google e também ajuda a evitar bloqueadores de pop-up. |
OBRIGATÓRIO | |
| 2.8 | O complemento DEVE mostrar quem é o usuário conectado no momento. | RECOMENDADOS | |
| 3.0 | Geral | ||
| 3.1 | O complemento PRECISA obedecer às diretrizes gerais de aprovação do Google Workspace Marketplace. | OBRIGATÓRIO | |
| 3.2 | Se uma tarefa for iniciada em uma nova guia ou janela de qualquer uma das jornadas de iframe, ela DEVE fornecer uma mensagem fácil de entender para retornar ao Google Sala de Aula. | RECOMENDADOS | |
| 3.3 | O usuário PRECISA concluir a jornada usando um fluxo de trabalho de complemento e não mudar para um fluxo de trabalho de CourseWork ou usar o botão de compartilhamento do Google Sala de Aula. | OBRIGATÓRIO | |
| 3.4 | Escolha de localização: o idioma DEVE ser baseado na preferência local definida pelo navegador quando disponível. | RECOMENDADOS | |
| 3.5 | Se um complemento definir maxPoints, ele também PRECISA definir pointsEarned quando um estudante concluir um envio usando as credenciais do professor armazenadas (recomendado) OU quando o professor abrir o envio no iframe de revisão do trabalho do estudante. |
OBRIGATÓRIO | |
| 3.9 | Os complementos DEVEM estar em conformidade com as diretrizes de acessibilidade do nível AA da WCAG 2.1. Os desenvolvedores de complementos vão relatar manualmente que esse requisito é atendido no momento do envio e que o complemento continua em conformidade com mudanças futuras. | RECOMENDADOS | |
| 3.10 | Todos os erros encontrados por um usuário DEVEM ser legíveis. | RECOMENDADOS | |
| 3.11 | Se o studentViewUri, teacherViewUri ou studentWorkViewUri for iniciado de uma atividade ou curso copiado, o complemento NÃO DEVE mostrar uma página de erro no iframe. |
OBRIGATÓRIO | |
| 4.0 | Descoberta de anexos | ||
| 4.1 | Se um anexo exigir um envio do estudante, ele PRECISA incluir um studentWorkReviewUri para que seja tratado como um tipo de atividade e não como um anexo de tipo de conteúdo. |
OBRIGATÓRIO | |
| 4.2 | O iframe de descoberta de anexos PRECISA fornecer uma interface do usuário que ofereça pelo menos uma das seguintes opções:
|
OBRIGATÓRIO | |
| 4.3 | O professor DEVE conseguir encontrar e acessar todo o conteúdo/atividades disponíveis para ele. | RECOMENDADOS | |
| 4.4 | O professor DEVE conseguir visualizar o conteúdo/atividade antes de se comprometer a anexá-lo à atividade. | RECOMENDADOS | |
| 4.5 | Se o professor precisar criar conteúdo/atividade antes de poder anexá-lo, esse trabalho DEVE ser concluído no iframe. | RECOMENDADOS | |
| 5.0 | Visualização do estudante | ||
| 5.1 | Quando o studentViewUri é iniciado, o complemento NÃO DEVE abrir o usuário do iframe para concluir uma tarefa.Se o complemento abrir o usuário do iframe, PRECISA haver uma mensagem ou outra indicação para que os estudantes retornem ao Google Sala de Aula. |
RECOMENDADOS | |
| 5.2 | Se uma atividade de complemento sair do iframe, DEVE haver uma prévia sobre a tarefa no iframe. | RECOMENDADOS | |
| 5.3 | Se presente, um botão ou link na atividade com o rótulo Entregar PRECISA causar uma solicitação de API para enviar o trabalho do estudante para revisão do professor. | OBRIGATÓRIO | |
| 6.0 | Visualização do professor | ||
| 6.1 | O professor DEVE conseguir ver o que o estudante verá ao fazer a atividade. | RECOMENDADOS | |
| 7.0 | Revisão do trabalho do estudante | ||
| 7.1 | Se o studentWorkReviewUri for iniciado, o complemento PRECISA renderizar o trabalho do estudante para revisão do professor no iframe. O material complementar pode ser vinculado fora do iframe. |
OBRIGATÓRIO | |
| 7.2 | O complemento NÃO DEVE permitir a navegação entre estudantes na visualização studentWorkReviewUri. A navegação entre estudantes PRECISA ocorrer apenas na interface do Google Sala de Aula. |
OBRIGATÓRIO | |
| 8.0 | Suporte para dispositivos móveis do Google Sala de Aula | ||
| 8.1 | Quando o app Google Sala de Aula para dispositivos móveis inicia um teacherViewUri, studentViewUri ou studentWorkReviewUri, o URL PRECISA abrir o app nativo para dispositivos móveis do parceiro ou o app da Web para dispositivos móveis do parceiro e, em ambos os casos, o link direto para a visualização correta. Se o dispositivo não for compatível, uma mensagem PRECISA ser mostrada ao usuário para informar que é um dispositivo não compatível e, idealmente, quais dispositivos são compatíveis. |
OBRIGATÓRIO | |
| 8.2 | O trabalho do estudante DEVE poder ser concluído em um dispositivo móvel. | RECOMENDADOS | |
| 9.0 | Outros recursos | ||
| 9.1 | Se os professores puderem colar links para seu conteúdo como anexos de link, você DEVE fazer upgrade dos links para anexos de complementos. | RECOMENDADOS | |
| 9.2 | Se você usar uma integração do CourseWork para criar atividades fora do Google Sala de Aula, DEVE criar anexos de complementos por padrão para todos os links compatíveis com seu complemento. | RECOMENDADOS | |
Registro de alterações
| Versão 1.1 | Atualizado em 5 de dezembro de 2024 |
| 1.1, 1.3, 3.2, 3.10, 4.4, 5.2 | Mudou de OBRIGATÓRIO para RECOMENDADO. |
| 3.12 | Removido. |
| 5.3 | Reformulado. Uma mudança recente permite que os desenvolvedores de complementos entreguem envios de estudantes de forma confiável usando a API. |
| Versão 1.0 | Atualizado em 30 de abril de 2024 |
| 1.1 | Combinou 1.1 e 1.2 em um único requisito. |
| 2.1 | Combinou 2.1 e 2.5 em um único requisito. |
| 2.2 | Combinou 2.2, 2.3 e 2.4 em um único requisito. |
| 3.5 | Combinou 3.5, 3.6 e 3.7 em um único requisito. |
| 3.10 | Adicionou o requisito de que o complemento nunca entre em um estado ininteligível ou irrecuperável. |
| 3.11, 3.12 | Combinou 5.5, 5.6, 6.3, 6.4, 7.5 e 7.6 em dois novos requisitos. |
| 4.2 | Expandiu a descrição das experiências aceitáveis de descoberta de anexos. |
| 4.3 | Renumerado, anteriormente 4.2. Também mudou de OBRIGATÓRIO para RECOMENDADO. |
| 4.4 | Renumerado, anteriormente 4.3. |
| 4.5 | Renumerado, anteriormente 4.4. |
| 5.2 | Renumerado, anteriormente 5.3. |
| 5.3 | Renumerado, anteriormente 5.2. |
| 9.1 | Adicionou uma recomendação para fazer upgrade de links colados para anexos. |
| 9.2 | Adicionou uma recomendação para criar anexos de complementos por padrão ao criar atividades do CourseWork de forma programática. |
| 2.6, 3.7, 3.8, 6.2, 7.3, 7.4 | Removido. |
| Versão 0.3 | Atualizado em 22 de novembro de 2022 |
| 2.3 | Correção da orientação da dica de login. |
| 2.4 | Incorporou um cenário em que a implementação de hd é
necessária. |
| 3.2 | Reformulou "fornecer caminho". |
| 5.5, 5.6, 6.3, 6.4, 7.5, 7.6 | Adicionou orientações obrigatórias e recomendadas para a cópia de cursos para
studentViewUri, teacherViewUri e
studentWorkReviewUri. |
| Versão 0.2 | Atualizado em 29 de outubro de 2021 |
| 1.3 | Ajustou o texto para deixar a intenção mais clara. |
| 3.1 | Adicionou "O complemento PRECISA obedecer às diretrizes gerais de aprovação do GWM encontradas no site". |
| 3.9 | A WCAG mudou de OBRIGATÓRIO para RECOMENDADO. |
| 5.1 | Mudou de OBRIGATÓRIO para RECOMENDADO. |
| 5.3 | Adicionou "Se os complementos aparecerem fora do iframe, PRECISA haver uma prévia sobre a tarefa no iframe." |
| 5.4 | Adicionou "Se o complemento aparecer fora do iframe, DEVE haver uma solicitação para que os estudantes retornem ao Google Sala de Aula." |
| 8.1 | Adicionou "Se o dispositivo não for compatível, uma mensagem PRECISA ser mostrada ao usuário para informar que é um dispositivo não compatível e, idealmente, quais dispositivos são compatíveis". |
| 8.2 | O trabalho do estudante em dispositivos móveis mudou de OBRIGATÓRIO para RECOMENDADO. |
| Versão 0.1 | Atualizado em 22 de setembro de 2021 |
| Versão inicial. |