첨부파일과 상호작용

이 페이지에서는 연결을 만들기 위한 구현 세부정보를 설명하고 작업하고 있습니다. 게시자가 첨부파일 관련 매개변수를 지정합니다.

연결 만들기

적절한 대상에게 CREATE 요청을 실행하여 첨부파일을 만듭니다. courses.*.addOnAttachments.create 엔드포인트 요청에는 요청 본문에 있는 AddOnAttachment의 인스턴스입니다.

첨부파일을 만들 때는 다음 필드가 필요합니다.

title: 첨부파일의 문자열 이름입니다.
teacherViewUri: 첨부파일의 교사 보기용 URI입니다.
studentViewUri: 첨부파일의 학생 뷰 URI입니다.
studentWorkReviewUri: 교사가 학생의 과제를 볼 수 있는 URI입니다. 첨부파일도 마찬가지입니다. 이 필드는 활동 유형 첨부파일에만 필요합니다.

다음과 같은 선택적인 필드를 포함할 수 있습니다.

첨부파일 만료일을 지정하는 경우 dueDate 및 dueTime입니다.
maxPoints: 첨부파일의 최대 성적입니다. 0이 아닌 값이어야 합니다. 성적 반환을 지원하려는 경우 활동 유형 첨부파일에 적용 전용입니다.

이 필드에 대한 자세한 내용은 AddOnAttachment 리소스 참조를 확인하세요.

학생 제출물 세부정보

일반적인 제출 워크플로는 다음 단계를 따릅니다.

학생이 studentViewUri를 실행하여 활동을 완료합니다.
부가기능이 getAddOnContext 메서드에서 submissionId를 가져옵니다. 사용자 인증 정보를 사용합니다
submissionId 및 attachmentId은(는) 부가기능에 의해 저장됩니다. 학생 과제물의 고유 식별자로 사용됩니다. 만약 클래스룸에서 과제를 복사한 경우 이 두 매개변수의 복합 키를 사용하여 복사된 과제입니다. 자세한 내용은 복사된 콘텐츠 페이지를 참고하세요.
학생 과제물을 복습하는 데 관심이 있는 교사가 studentWorkReviewUri 요청에는 다음 쿼리 매개변수가 포함됩니다. courseId, itemId, itemType, attachmentId, submissionId
부가기능 개발자는 이 4개의 ID를 사용하여 학생 과제물을 검색합니다. 사용 courses.courseWork.addOnAttachments.studentSubmissions 엔드포인트를 사용하여 학생 제출물에 대한 정보 검색 또는 수정

제출 상태 감지

GET 요청을 courses.courseWork.addOnAttachments.studentSubmissions 엔드포인트를 사용하여 특정 submissionId에 관한 세부정보 사용자는 제출 성적이 포함된 AddOnAttachmentStudentSubmission 객체 (pointsEarned) 및 현재 상태 (postSubmissionState)가 있습니다. 제출 상태 다음 값 중 하나일 수 있습니다.

NEW: 학생이 제출물에 액세스한 적이 없는 경우
CREATED: 학생이 제출물을 만들었지만 아직 제출하지 않은 경우
TURNED_IN: 학생이 교사에게 과제물을 제출한 경우
RETURNED: 교사가 제출물을 학생에게 돌려준 경우
RECLAIMED_BY_STUDENT: 학생이 '제출을 취소'한 경우 확인할 수 있습니다

이 엔드포인트를 사용하여 부가기능에서 학생의 과제 상태를 감지합니다. 나 학생의 필요에 따라 학생에게 제공되는 뷰나 옵션을 상태를 반환합니다. 여기에는 다음과 같은 기능이 포함될 수 있습니다.

부가기능 내에서 과제 제출 상태를 표시합니다. 이로 인해 혼동을 피하고 학생들이 실수하지 않도록 과제를 제출하지 못할 수 있습니다.
제출물 수정 권한을 제한합니다. 과제가 '상태'인 경우 CREATED 또는 RECLAIMED_BY_STUDENT인 경우 학생이 수정할 수 있습니다. 제출할 수 있습니다. 과제의 상태가 TURNED_IN 또는 RETURNED인 경우 학생이 제출물을 수정하지 못할 수 있습니다.

성적 및 여러 첨부파일

하나의 부가기능 첨부파일만 사용하여 성적을 매길 수 있습니다. 과제를 참조하세요. 교사가 학생의 과제에 해당하는 활동 유형 첨부파일을 두 개 이상 만든 경우 maxPoints 값을 제공하면 첫 번째 첨부파일만 과제 성적 maxPoints 값을 설정하지 않은 상태로 두거나 0으로 설정하세요. 첨부파일에 대한 성적 반환 사용 중지

제출물 성적 설정하기

다음과 같이 PATCH 요청을 전송하여 학생 제출물을 수정할 수 있습니다. courses.courseWork.addOnAttachments.studentSubmissions 엔드포인트에 액세스할 수 있습니다. 요청 본문에는 AddOnAttachmentStudentSubmission 인스턴스가 포함되어야 합니다. 수정할 수 있습니다. 제출물의 성적을 수정하려면 pointsEarned 필드를 설정합니다. pointsEarned에 전달된 값은 다음 학생이 볼 수 있는 초안 성적이 됩니다. 클래스룸 UI에서 사용할 수 있습니다. 교사는 임시 성적을 수정할 수 있습니다. 해야 합니다. 채점 개요: 클래스룸 UI에서 성적 확인 방법 자세히 알아보기 선생님들에게 소개했습니다

다음 조건을 충족하는 경우에만 pointsEarned로 성적을 설정할 수 있습니다. true:

첨부파일의 maxPoints 값이 양수여야 합니다.
첨부파일을 처음 만든 부가기능이어야 합니다.

이미 만든 AddOnAttachment의 maxPoints도 수정할 수 있습니다. 값을 반환합니다.PATCHaddOnAttachments

성적을 설정해야 하는 경우

교사는 성적이 Google 클래스룸으로 다시 전달되는 시점을 선택할 수 있습니다. 이 중요한 차이점은 교사의 사용자 인증 정보를 교사만 성적을 수정할 수 있습니다.

성적을 통과할 수 있는 부가기능 시점이 2개 있습니다. Google 클래스룸: 학생이 과제를 완료하거나 선생님이 학생 과제물 리뷰 iframe에서 학생의 과제물이 열립니다.

학생이 과제를 완료할 때 성적을 설정하려면 교사의 오프라인 사용자 인증 정보를 가져와 이를 가져와 성적을 수정하는 데 사용할 수 있습니다. 확인할 수 있습니다. 이 방법은 이점:

원활한 성적 업데이트를 제공합니다. 교사에게 특별 교육을 받을 필요가 없습니다. 클래스룸 UI에 성적이 입력되도록 하세요.
과제를 통해 수업의 진행 상황을 실시간으로 파악할 수 있습니다. 교사는 학생이 첨부파일을 완성했을 때 성적을 매기면 이해도를 높일 수 있습니다. 학생의 40%에게 이해할 수 없습니다.

이 접근 방식을 사용하면 비동기식 접근 방식으로도 채점이 가능합니다. 동기화할 수 있습니다. 주기적으로 AddOnAttachmentStudentSubmission를 폴링할 수 있습니다. 엔드포인트를 사용하여 학생이 과제물을 제출한 시점을 감지합니다. 데이터가 저장된 사용자 인증 정보를 사용하여 제출물의 성적을 설정합니다.

학생 세션 중에 교사의 사용자 인증 정보를 로드하지 않으려면 활성 선생님이 학생의 활동기록을 로드할 때 학생 과제물 검토 iframe에 제출하세요. 하지만 이렇게 해도 클래스룸 UI에서 성적을 확인할 때 특히 원활한 사용자 환경이 제공됩니다. 실시간으로 업데이트되지 않으며 교사는 매 시간마다 제출물의 학생 과제물 리뷰 iframe입니다.

과제 성적의 변화 감지하기

교사는 클래스룸에서 성적 설정을 클래스룸에 추가될 수 있습니다. 이러한 수정사항은 포함:

할당된 포인트 값 변경
과제의 maxPoints 값 변경
과제 채점 여부 변경

과제의 현재 평가 설정을 보려면 courses.courseWork 엔드포인트에 대한 GET 요청 응답에는 현재 maxPoints 값입니다. 미채점 과제에 null 또는 0이 있습니다. maxPoints 값입니다.

성적을 다시 클래스룸으로 통과한 경우 courses.courseWork.addOnAttachments.studentSubmissions 엔드포인트에서 부가기능 첨부파일의 성적을 변경할 수 없습니다. 성적 값은 pointsEarned 필드 이 값을 확인하고 필요한 경우 업데이트해 보세요. 제품을 통해 교사가 특정 학생의 점수를 수정할 수 있는 경우 있습니다.