구현 전략

이 페이지에서는 부가기능 웹 애플리케이션과 Google Classroom 부가기능 API 간의 주요 상호작용을 간략하게 설명합니다.

첨부파일 검색 iframe

첨부파일 검색 iframe은 부가기능 교사를 위한 방문 페이지입니다. 이 보기와 관련하여 다음 조치를 취해 보세요.

  • 연결 검색 iframe이 열리면 itemType에 따라 courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest 또는 announcements.GetAddOnContextRequest를 생성하여 사용자 역할을 검증하고 supportsStudentWork 값을 가져옵니다.
  • 콘텐츠 검색 또는 제작 UI를 표시합니다. 실행 유효성 검사 응답에서 supportsStudentWork 값을 기준으로 활동 유형 연결을 생략할 수도 있습니다.
  • 교사 선택에 따라 한 개 이상의 부가기능 create 요청을 통해 과제에 첨부파일을 추가합니다.

기타 iframe

학생 뷰 iframe, 학생 과제물 검토 iframe, 교사 뷰 iframe은 모두 클래스룸 과제를 수정하는 것이 아니라 사용자에게 콘텐츠를 표시하기 위한 것입니다. 이러한 견해와 관련하여 다음 조치를 취하는 것이 좋습니다.

  • iframe이 열리면 사용자의 OAuth 동의를 얻은 후 역할 및 연결 ID를 검증합니다.

    • 현재 사용자가 학생인 경우 응답의 submissionId를 학생 과제물과 연결합니다. 이는 성적을 전달하고 채점 도구에서 교사에게 학생 과제물을 표시하는 데 필요합니다. 여러 뷰에서 submissionIds와 일치합니다.
    • 부가기능에 이미 attachmentId가 알려진 경우 적절한 연결 UI를 표시합니다.
    • 그렇지 않은 경우 이 첨부파일의 상위 게시물이 다른 게시물 또는 과정에서 복사된 경우여야 합니다. copyHistory를 사용하여 부가기능이 알고 있는 최신 사본을 식별하고 이 사본에서 설정을 복사하여 부가기능 측에 해당하는 새 연결 모델을 만듭니다. 그런 다음 적절한 첨부파일 UI를 표시합니다.