이 페이지에서는 연결을 만들기 위한 구현 세부정보를 설명하고 Google Cloud 도구를 소개합니다 게시자가 첨부파일 관련 매개변수를 지정합니다.
연결 만들기
적절한 대상에게 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
도 수정할 수 있습니다.
값을 반환합니다.PATCH
addOnAttachments
성적을 설정해야 하는 경우
교사는 성적이 Google 클래스룸으로 다시 전달되는 시점을 선택할 수 있습니다. 이 중요한 차이점은 교사의 사용자 인증 정보를 교사만 성적을 수정할 수 있습니다.
성적을 통과할 수 있는 부가기능 시점이 2개 있습니다. Google 클래스룸: 학생이 과제를 완료하거나 선생님이 과제를 수행할 때 학생 과제물 리뷰 iframe에서 학생의 과제물이 열립니다.
학생이 과제를 완료할 때 성적을 설정하려면 교사의 오프라인 사용자 인증 정보를 가져와 이를 가져와 성적을 수정하는 데 사용할 수 있습니다. 확인할 수 있습니다. 이 방법은 이점:
- 원활한 성적 업데이트를 제공합니다. 교사에게 특별 교육을 받을 필요가 없습니다. 클래스룸 UI에 성적이 입력되도록 하세요.
- 과제를 통해 수업의 진행 상황을 실시간으로 파악할 수 있습니다. 교사는 학생이 첨부파일을 완성했을 때 성적을 매기면 이해도를 높일 수 있습니다. 학생의 40%에게 이해할 수 없습니다.
이 접근 방식을 사용하면 비동기식 접근 방식으로도 채점이 가능합니다.
동기화할 수 있습니다. 주기적으로 AddOnAttachmentStudentSubmission
를 폴링할 수 있습니다.
엔드포인트를 사용하여 학생이 과제물을 제출한 시점을 감지합니다. 데이터가
저장된 사용자 인증 정보를 사용하여 제출물의 성적을 설정합니다.
학생 세션 중에 교사의 사용자 인증 정보를 로드하지 않으려면 활성 선생님이 학생의 활동기록을 로드할 때 학생 과제물 검토 iframe에 제출하세요. 하지만 이렇게 해도 클래스룸 UI에서 성적을 확인할 때 특히 원활한 사용자 환경이 제공됩니다. 실시간으로 업데이트되지 않으며 교사는 매 시간마다 제출물의 학생 과제물 리뷰 iframe입니다.
과제 성적의 변화 감지하기
교사는 클래스룸에서 성적 설정을 클래스룸에 추가될 수 있습니다. 이러한 수정사항은 포함:
- 할당된 포인트 값 변경
- 과제의
maxPoints
값 변경 - 과제 채점 여부 변경
과제의 현재 평가 설정을 보려면
courses.courseWork
엔드포인트에 대한 GET
요청 응답에는
현재 maxPoints
값입니다. 미채점 과제에 null 또는 0이 있습니다.
maxPoints
값입니다.
성적을 다시 클래스룸으로 통과한 경우
courses.courseWork.addOnAttachments.studentSubmissions
엔드포인트에서
부가기능 첨부파일의 성적을 변경할 수 없습니다. 성적 값은
pointsEarned
필드 이 값을 확인하고 필요한 경우 업데이트해 보세요.
제품을 통해 교사가 특정 학생의 점수를 수정할 수 있는 경우
있습니다.