Interagir com anexos

Esta página discute detalhes de implementação para criar um anexo e trabalhar com os envios dos alunos. Talvez seja necessário fornecer parâmetros relacionados a anexos ao fazer essas solicitações.

Criar um anexo

Crie um anexo enviando uma solicitação CREATE para o servidor apropriado. endpoint courses.*.addOnAttachments.create. Sua solicitação deve incluir um instância de AddOnAttachment no corpo da solicitação.

Os campos a seguir são obrigatórios ao criar um anexo:

  • title: o nome da string do anexo.
  • teacherViewUri: o URI da visualização do professor do anexo.
  • studentViewUri: o URI da visualização do estudante do anexo.
  • studentWorkReviewUri: o URI em que o professor pode conferir o trabalho do estudante o anexo. Esse campo só é obrigatório para anexos do tipo atividade.

Você pode incluir alguns dos seguintes campos opcionais:

  • dueDate e dueTime se especificarem a data de entrega do anexo.
  • maxPoints: a nota máxima do anexo. Precisa ser um valor diferente de zero caso queira apoiar a transferência de notas. Aplica-se a anexos do tipo atividade .

Consulte a referência do recurso AddOnAttachment para mais detalhes sobre esses campos.

Detalhes do envio do estudante

Um fluxo de trabalho de envio típico segue estas etapas:

  1. Um estudante inicia a studentViewUri para concluir uma atividade.
  2. O complemento extrai um submissionId do método getAddOnContext. usando as credenciais de estudante.
  3. Os arquivos submissionId e attachmentId são armazenados pelo complemento. desenvolvedor como o identificador exclusivo do trabalho do estudante. Caso o um professor copiar uma tarefa no Google Sala de Aula, você poderá usar chave composta desses dois parâmetros para exibir um novo anexo na atividade copiada. Confira mais detalhes na página sobre conteúdo copiado.
  4. Um professor interessado em revisar o trabalho de um estudante inicia o studentWorkReviewUri: A solicitação inclui os seguintes parâmetros de consulta: courseId, itemId, itemType, attachmentId e submissionId.
  5. O desenvolvedor do complemento usa esses quatro IDs para recuperar o trabalho do estudante. Usar endpoint courses.courseWork.addOnAttachments.studentSubmissions para recuperar ou modificar informações sobre o envio de um estudante.
.

Detectar o estado do envio

Emita uma solicitação GET para o endpoint do courses.courseWork.addOnAttachments.studentSubmissions para receber detalhes sobre um submissionId específico. Você recebe um Objeto AddOnAttachmentStudentSubmission, que contém a nota do envio (pointsEarned) e o estado atual (postSubmissionState). O estado do envio pode ter um dos seguintes valores:

  • NEW, se o estudante nunca tiver acessado o envio.
  • CREATED, se o aluno criou um envio, mas ainda não o enviou.
  • TURNED_IN, se o estudante tiver enviado o trabalho para o professor.
  • RETURNED, se o professor tiver devolvido o trabalho para o aluno.
  • RECLAIMED_BY_STUDENT, se o estudante tiver cancelado o envio. o trabalho.

Use este endpoint para detectar o estado do trabalho do estudante no seu complemento. Você pode ajustar as visualizações ou opções fornecidas aos estudantes dependendo retornado. Isso pode incluir recursos como:

  • Mostrando o status de entrega de atividades no seu complemento. Isso pode ajudar os estudantes a evitar possíveis confusões e garantir que não façam nada por engano; não conseguiram entregar uma atividade.
  • Restringindo privilégios de edição de envio. Se a tarefa tiver status CREATED ou RECLAIMED_BY_STUDENT, talvez o estudante tenha permissão para editar o envio deles. Se a atividade tiver o status TURNED_IN ou RETURNED, talvez o estudante não tenha permissão para editar o trabalho enviado.

Notas e vários anexos

Só é possível usar um anexo de complemento para dar a nota de uma única vez atribuição. Se um professor criar mais de um anexo do tipo de atividade fornecer um valor maxPoints, apenas o primeiro anexo desse tipo poderá definir a a nota da tarefa. Deixe o valor maxPoints sem definição ou defina-o como zero a desativar a transferência de notas de um anexo.

Definir a nota de um envio

Você pode modificar o envio de um estudante enviando uma solicitação PATCH ao endpoint do courses.courseWork.addOnAttachments.studentSubmissions. A solicitação o corpo precisa incluir uma instância de AddOnAttachmentStudentSubmission com o valores modificados. Defina o campo pointsEarned para modificar a nota de um envio. O valor transmitido em pointsEarned se torna uma nota de rascunho visível para o professor na interface do Google Sala de Aula. Os professores podem modificar a nota temporária antes de devolver a atividade aos estudantes. Consulte Visão geral da avaliação na interface do Google Sala de Aula, que mostra como as notas são apresentado aos professores.

Você só poderá definir a nota com pointsEarned se as seguintes condições forem: verdadeiro:

  • O anexo precisa ter um valor maxPoints positivo.
  • O complemento precisa ter sido o criador original do anexo.

Também é possível modificar um maxPoints de AddOnAttachment já criado emitindo uma solicitação PATCH para o endpoint addOnAttachments.

Quando definir uma nota

É possível escolher quando uma nota é devolvida para o Google Sala de Aula. A uma distinção importante é se você opta por armazenar as credenciais dos professores, somente o professor pode modificar a nota.

Há dois momentos complementares em que você pode passar uma nota para Google Sala de Aula: quando o estudante conclui o trabalho ou o professor abre o trabalho do aluno no iframe "Revisão dos trabalhos dos alunos".

Para dar notas quando o estudante terminar o trabalho, armazene um as credenciais off-line dos professores e, em seguida, recuperá-las e usá-las para modificar a nota quando o estudante terminar o trabalho. Esse método fornece algumas possíveis benefícios:

  • Facilite as atualizações de notas. Os professores não precisam para fazer as notas serem preenchidas na interface do Google Sala de Aula.
  • Fornecer insights em tempo real sobre o progresso de uma turma em uma tarefa. Ao definir as notas à medida que os estudantes concluem anexos, os professores têm uma ideia de seus alunos entender sem abrir cada envio.

Essa abordagem também permite uma abordagem assíncrona para classificar sincronizar. Faça pesquisas periódicas no AddOnAttachmentStudentSubmission para detectar quando um estudante enviou o trabalho. Quando enviado, defina a nota da atividade usando as credenciais armazenadas.

Se você não quiser carregar as credenciais do professor durante uma sessão de aluno, você poderá usar as credenciais do professor ativo quando ele carregar no iframe "Revisão dos trabalhos dos alunos". No entanto, isso pode não fornecer uma experiência do usuário ainda melhor, como notas na interface do Google Sala de Aula. não são atualizadas em tempo real, e os professores teriam que abrir todas iframe "Revisão dos trabalhos dos alunos" do envio.

Detectar mudanças nas notas das atividades

os professores podem editar as configurações de notas Google Sala de Aula após a criação de uma atividade. Essas edições podem incluem:

  • Alterando a pontuação atribuída.
  • Alterar o valor de maxPoints de uma atividade.
  • Alterar se a tarefa deve receber nota.

Para acessar as configurações de avaliação atuais de uma atividade, recomendamos que você envie uma solicitação GET ao endpoint courses.courseWork. A resposta inclui o valor maxPoints atual. Uma atividade sem nota tem um valor nulo ou zero Valor de maxPoints.

Se você tiver passado uma nota para o Google Sala de Aula, use o courses.courseWork.addOnAttachments.studentSubmissions endpoint para buscar ou alterar a nota de um anexo de complemento. O valor da nota é definido usando o método pointsEarned. Verifique e, se necessário, atualize esse valor se o produto permite que os professores editem a pontuação de um estudante em uma determinada atividades.