이 가이드에서는 웹사이트 또는 애플리케이션에서 부가기능 첨부파일을 만드는 방법을 알아봅니다. 이러한 상호작용은 CourseWork API를 사용하여 과제를 만드는 것과 비슷합니다. 엔드포인트입니다. 사용자가 부가기능 첨부파일을 만들 수 있도록 이 여정을 구현하세요. 광고를 게재할 수 있습니다
워크플로
연결 생성 과정은 개략적으로 다음 순서를 따릅니다.
- 교사 사용자가 웹사이트 또는 앱을 엽니다. 사용자가 광고를 보고 학생에게 할당할 수 있습니다.
- 사용자가 부가기능 첨부파일을 만들 수 있는지 확인합니다.
- 사용자가 부가기능 첨부파일을 만들 수 없는 경우 CourseWork를 만듭니다. 링크를 링크 자료로 사용합니다.
- 사용자가 부가기능 첨부파일을 만들 수 있는 경우 다음을 수행합니다.
- 과제를 만듭니다.
- 선택한 콘텐츠로 연결되는 부가기능 첨부파일을 만들고 새 할당과 연결할 수 있습니다
- 과제가 생성되었다고 교사에게 알립니다.
각 작업은 다음 섹션에서 설명합니다.
사용자가 부가기능 첨부파일을 만들 수 있는지 확인하기
자격 요건을 충족하는 사용자를 대신하여 부가기능 첨부파일을 만들 수 있습니다. 적격 사용자는 만들려는 교육 과정의 교사인 사용자입니다. 클래스룸 및 클래스룸 Learning 또는 Education Plus 할당된 Google Workspace for Education 버전 라이선스
먼저 사용자가 지정된 Course
에서 부가기능을 만들 수 있는지 확인합니다.
courses.checkAddOnCreationEligibility
엔드포인트에 요청을 실행합니다.
수업 ID가 포함됩니다.
Python
eligibility_response = (
classroom_service.courses()
.checkAddOnCreationEligibility(courseId=course_id)
.execute()
)
is_create_attachment_eligible = (
eligibility_response.get('isCreateAttachmentEligible')
)
print(f'User eligibility for course {eligibility_response.get("courseId")}'
f': {is_create_attachment_eligible}.')
사용자가 자격을 충족하면 응답에 불리언 값이 포함됩니다.
isCreateAttachmentEligible
값이 true
(으)로 설정됨 사용자가 자격요건을 충족하지 않는 경우
응답이 isCreateAttachmentEligible
불리언을 반환하지 않습니다.
자격 요건에 따라 사용자를 라우트합니다.
자격 요건에 따라 사용자의 부가기능 첨부파일을 만들 수 있는지 여부가 결정됩니다.
부적격 사용자
사용자가 부가기능 첨부파일을 만들 수 없는 경우 새 CourseWork
를 만듭니다.
과 함께 Link
로 할당합니다.
Python
if not is_create_attachment_eligible:
coursework = {
'title': 'My CourseWork Assignment with Link Material',
'description': 'Created using the Classroom CourseWork API.',
'workType': 'ASSIGNMENT',
'state': 'DRAFT', # Set to 'PUBLISHED' to assign to students.
'maxPoints': 100,
'materials': [
{'link': {'url': my_content_url}}
]
}
assignment = (
service.courses()
.courseWork()
.create(courseId=course_id, body=coursework)
.execute()
)
print(
f'Link Material assignment created with ID: {assignment.get("id")}'
)
응답에는 요청된 과정의 과제와 콘텐츠가 포함되어 있습니다.
첨부되어 있습니다. 사용자는 Link
를 클릭하여 사이트의 콘텐츠를 새 창에서 열 수 있습니다.
탭
그림 1. 링크 자료가 포함된 CourseWork 과제 초안의 교사 보기
요건을 충족하는 사용자
사용자가 부가기능 첨부파일을 만들 수 있는 경우 다음을 수행합니다.
- 첨부파일 없이 새
CourseWork
과제를 만듭니다. - 부가기능 첨부파일을 만듭니다.
AddOnAttachment
의itemId
를 새로 만든id
있습니다.- 각 보기에 대해 사용자가 선택한 콘텐츠의 URL을 제공해야 합니다. 자세히 알아보세요.
Python
if is_create_attachment_eligible:
coursework = {
'title': 'My CourseWork Assignment with Add-on Attachment',
'description': 'Created using the Classroom CourseWork API.',
'workType': 'ASSIGNMENT',
'state': 'DRAFT', # Set to 'PUBLISHED' to assign to students.
'maxPoints': 100,
}
assignment = (
classroom_service.courses()
.courseWork()
.create(courseId=course_id, body=coursework)
.execute()
)
print(
f'Empty assignment created with ID: {assignment.get("id")}'
)
attachment = {
'teacherViewUri': {'uri': teacher_view_url},
'studentViewUri': {'uri': student_view_url},
'studentWorkReviewUri': {'uri': grade_student_work_url},
'title': f'Test Attachment {test_label}',
}
add_on_attachment = (
service.courses()
.courseWork()
.addOnAttachments()
.create(
courseId=course_id,
itemId=assignment.get("id"), # ID of the new assignment.
body=attachment,
)
.execute()
)
print(
f'Add-on attachment created with ID: {add_on_attachment.get("id")}'
)
부가기능은 클래스룸에서 첨부파일 카드로 표시됩니다. URL 해당 각 View의 iframe.