첨부파일은 사용자가 보고 상호작용하는 콘텐츠입니다.
이 가이드에서는 Google 클래스룸의 첨부파일을 간략하게 살펴보고 첨부파일과 관련된 몇 가지 중요한 용어를 정의합니다.
매우 높은 수준에서 부가기능의 역할은 첨부파일을 만들고 관리하는 것입니다.
부가기능을 사용하면 학생이 Google 클래스룸 내에서 직접 콘텐츠에 액세스할 수 있습니다. CourseWork API를 사용하여 만든 과제와 달리, 부가기능 첨부파일은 사용자가 Google 클래스룸을 나가지 않고도 맞춤설정된 양방향 환경을 지원합니다.
교사가 과제에 첨부파일을 추가합니다. 과제에는 최대 10개의 첨부파일을 추가할 수 있지만, 단일 유형의 첨부파일은 8개까지만 추가할 수 있습니다. 첨부파일의 예로는 YouTube 동영상, Google 문서, 외부 링크가 있습니다. Google Drive의 파일이나 컴퓨터에서 업로드한 파일을 첨부할 수도 있습니다.
그림 1. 과제를 만들거나, 보거나, 완료할 때 첨부파일이 카드로 표시됩니다.
첨부파일 형식
부가기능 첨부파일에는 활동과 콘텐츠라는 두 가지 유형이 있습니다.
활동 유형 첨부파일은 퀴즈나 서면 답변과 같이 학생의 제출 또는 제출 작업이 필요한 첨부파일입니다. 콘텐츠 유형 첨부파일은 동영상이나 뉴스 기사와 같이 학생 제출이 필요하지 않은 보기 전용 자료입니다.
첨부파일 관련 API 상호작용은 첨부파일 유형에 따라 약간 다릅니다. 부가기능 API를 통한 첨부파일과의 상호작용에 관한 자세한 내용은 첨부파일과 상호작용 가이드 페이지를 참고하세요.
자동으로 평가된 첨부파일
활동 유형 첨부파일의 경우 성적을 Google 클래스룸으로 다시 전달할 수 있습니다. 이렇게 하면 특정 과제의 성적 필드가 초안 성적으로 채워집니다. 성적은 0 이상의 모든 십진수가 될 수 있습니다. 구현 세부정보는 첨부파일과 상호작용 가이드 페이지를 참고하세요.
이 기능은 교사들이 많이 요청하는 기능입니다. 사용자 환경 연구에 따르면 많은 교사가 부가기능 활동 성적이 Google 클래스룸에 자동으로 반환된다고 가정합니다.
[[["이해하기 쉬움","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,["# Attachments\n\n**Attachments** are the pieces of content that users view and interact with.\nThis guide provides a brief overview of attachments in Google Classroom and\ndefines some important attachment-related terminology.\n\nAt a very high level, *an add-on's role is to create and manage attachments* .\nAdd-ons provide an opportunity for students to access your content directly\nwithin Google Classroom. Unlike assignments created using the [CourseWork\nAPI](/workspace/classroom/reference/rest/v1/courses.courseWork), add-on attachments support your customized and interactive experiences\nwithout requiring the user to leave Google Classroom.\n\nTeachers add attachments to **assignments**. An assignment can have up to ten\nattachments, though only eight of any single type. Examples of attachments\ninclude YouTube videos, Google Docs, or external links. You can also attach\nfiles from Google Drive or uploaded from your computer.\n\n**Figure 1.** Attachments appear as cards when creating, viewing, or completing\nan assignment.\n\nAttachment types\n----------------\n\nThere are two types of add-on attachments: **activity** and **content**.\nActivity-type attachments are any that require a student submission or turn-in\naction, such as a quiz or written response. Content-type attachments are\nview-only materials that don't require a student submission, such as videos or\nnews articles.\n| **Note:** Consider automatically saving progress as students work through activities. Doing so may prevent user frustration; a student may be unable to complete an activity in a single session or they might navigate away from the activity before completing their work.\n\nAttachment-related API interactions differ slightly depending on the attachment\ntype. For details regarding interactions with attachments through the add-ons\nAPI, visit the [Interacting with attachments](/workspace/classroom/add-ons/developer-guides/attachment-interactions) guide page.\n\nAutomatically graded attachments\n--------------------------------\n\nYou can **pass grades back to Google Classroom** for activity-type\nattachments. Doing so populates the grade field for a particular assignment with\na draft grade. The grade can be any decimal number zero or greater. See our\n[Interacting with attachments](/workspace/classroom/add-ons/developer-guides/attachment-interactions) guide page for implementation details.\n\nNote that *this is a heavily requested feature by teachers*; our user experience\nresearch has shown that many teachers assume that add-on activity grades are\nautomatically be returned to Google Classroom.\n\nCreate attachments from a third-party site\n------------------------------------------\n\nYou can create add-on attachments programmatically from outside of\nGoogle Classroom. The interactions are similar to [creating assignments using\nthe CourseWork API endpoints](/workspace/classroom/guides/manage-coursework#create_assignments). See the dedicated [Create attachments outside of\nGoogle Classroom](/workspace/classroom/add-ons/developer-guides/third-party-first-journey) guide for implementation details."]]
