첨부파일 검색 iframe은 클래스룸 작업을 만드는 동안 부가기능을 열 때 교사에게 표시되는 초기 뷰입니다. 첨부파일은 학생이 상호작용하도록 하려는 콘텐츠 또는 활동입니다.
클래스룸 수업 내에서 교사가 새 게시물 (예: 과제, 공지사항, 질문)을 만들고 부가기능 드롭다운 목록에서 부가기능을 선택합니다 (그림 1).
그림 1. 교사가 첨부할 수 있는 가능한 부가기능 옵션을 포함한 과제 생성 보기
교사가 부가기능을 선택하면 클래스룸에서 첨부파일 검색 iframe을 만들고 부가기능의 실행 URL을 로드합니다. 관련 iframe 쿼리 매개변수는 실행 URL로 전달됩니다 (그림 2).
그림 2. iframe의 첨부파일 검색 UI의 예
첨부파일 검색 보기를 부가기능의 교사 방문 페이지로 생각하세요. 일반적으로 교사는 iframe 내에서 파트너의 웹 애플리케이션을 사용하여 스트림 항목에 첨부할 콘텐츠를 선택합니다.
부가기능 애플리케이션은 스트림 항목이 공지사항인지, 과제인지, 수업 자료인지에 따라 표시되는 콘텐츠를 제한할 수 있습니다. 그러면 부가기능 애플리케이션이 Classroom API를 호출하여 첨부파일을 만들고 과제에 첨부합니다.
교사가 첨부파일 선택 및 생성을 완료하면 부가기능에서 iframe을 닫도록 요청하는 postMessage 페이로드를 전송합니다. iframe이 닫히고 교사는 첨부파일을 확인합니다. 교사는 과제에서 첨부파일을 미리 보거나 삭제할 수 있습니다 (그림 3). 교사는 학생에게 스트림 항목을 할당하여 생성 흐름을 완료합니다.
그림 3. 활동 유형 부가기능 첨부파일이 3개 있는 과제 생성 보기
사용자 환경 고려사항
처음 열 때 부가기능은 교사에게 로그인하라는 메시지를 표시해야 합니다.
모든 Classroom API 호출에는 Google 싱글 사인온이 필요합니다. 제품에 별도의 로그인 시스템이 있는 경우 계정을 연결해야 합니다.
교사는 최종 선택을 하기 전에 iframe 내에서 첨부파일을 미리 볼 수 있어야 합니다.
교사는 첨부 가능한 콘텐츠를 검색하거나 둘러볼 수 있어야 합니다.
부가기능은 최근 콘텐츠, 내 콘텐츠, 학습 기술별 필터링 등 다양한 보기를 제공할 수 있습니다.
부가기능은 iframe 내에서 첨부 가능한 새 항목을 만드는 기능을 제공해야 합니다.
사용자 환경 요구사항에 관한 자세한 내용은 클래스룸 부가기능 요구사항 체크리스트를 참고하세요.
라이선스 상태
부가기능에 제품 라이선스가 필요한 경우 라이선스가 없는 교사가 이 상황을 해결하는 방법을 설명하는 명확한 메시지가 표시되어야 합니다. 라이선스 제한으로 인해 교사가 사용할 수 없는 콘텐츠도 숨기거나 사용 중지하는 것이 좋습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Attachment Discovery iframe\n\nThe **Attachment Discovery iframe** is the initial view shown to a teacher when\nopening an add-on during the creation of a\nClassroom task. An\n**attachment** is the content or activity that you intend for students to\ninteract with.\n\nFrom within a Classroom course, a teacher creates a new post (for\nexample, an assignment, announcement, or question) and selects an\nadd-on from the add-on\ndrop-down list (Figure 1).\n\n**Figure 1.** View of an assignment\ncreation including the possible add-on options a\nteacher can attach.\n\nOnce a teacher selects an add-on,\nClassroom creates an Attachment Discovery iframe and loads the\nadd-on's launch URL. Any relevant [iframe query\nparameters](/workspace/classroom/add-ons/developer-guides/iframes) are passed to the launch URL (Figure 2).\n\n**Figure 2.** An example of an **attachment discovery** UI in an iframe.\n\nThink of the Attachment Discovery view as the landing page for teachers in your\nadd-on. Typically, the teacher uses the partner's web\napplication within the iframe to select content to attach to their stream item.\nThe add-on application might restrict which content is\nshown depending on whether the stream item is an announcement, assignment, or\ncourse material. The add-on application then makes\nClassroom API calls to create and attach the attachment to the\nassignment.\n\nWhen the teacher is finished selecting and creating attachments, the\nadd-on sends a `postMessage` payload requesting the\niframe to be closed. The iframe closes and the teacher then sees the\nattachments, which they might then choose to preview or remove from the\nassignment (Figure 3). The teacher completes the creation flow by assigning the\nstream item to their students.\n\n**Figure 3.** View of an assignment creation with three activity-type\nadd-on attachments.\n\nUser experience considerations\n------------------------------\n\n- On initial opening, the add-on must prompt the teacher to sign in.\n- Google single sign-on is required for all Classroom API calls. If your product has a separate login system, you must link accounts.\n- A teacher must be able to preview an attachment within the iframe before making their final selection.\n- A teacher should be able to search for, or browse through, attachable content.\n- The add-on may provide a variety of views such as recent content, my content, and filter by learning skills.\n- The add-on must provide an ability to create a new attachable item from within the iframe.\n\nSee the Classroom add-on [requirements checklist](/workspace/classroom/add-ons/requirements) for more details\non user experience requirements.\n\nLicensing status\n----------------\n\nIf your add-on requires a license to your product, a\nclear message should be shown to explain how a teacher without a license can\nremedy the situation. Consider also hiding or disabling content that's not\navailable to a teacher due to licensing restrictions."]]
그림 1. 교사가 첨부할 수 있는 가능한 부가기능 옵션을 포함한 과제 생성 보기
