คู่มือนี้จะอธิบายเกี่ยวกับการสร้างไฟล์แนบของส่วนเสริมในเว็บไซต์หรือแอปพลิเคชัน การโต้ตอบจะคล้ายกับการสร้างงานโดยใช้ปลายทาง CourseWork API นำเส้นทางนี้ไปใช้เพื่ออนุญาตให้ผู้ใช้สร้างไฟล์แนบของส่วนเสริมจากเว็บไซต์หรือแอปพลิเคชัน
ขั้นตอนการทำงาน
ในระดับสูง เส้นทางการสร้างไฟล์แนบจะเป็นไปตามลำดับต่อไปนี้
- ผู้ใช้ที่เป็นครูเปิดเว็บไซต์หรือแอปของคุณ จึงเลือกเนื้อหาบางส่วนที่จะมอบหมายให้นักเรียน
- ตรวจสอบว่าผู้ใช้สร้างไฟล์แนบของส่วนเสริมได้
- หากผู้ใช้สร้างไฟล์แนบของส่วนเสริมไม่ได้ ให้สร้างงานของ CourseWork โดยระบุ URL ไปยังเนื้อหาที่เลือกเป็นสื่อการเรียนการสอนของชั้นเรียน
- หากผู้ใช้สร้างไฟล์แนบของส่วนเสริมได้ ให้ทำดังนี้
- สร้างงาน
- สร้างไฟล์แนบของส่วนเสริมที่ลิงก์ไปยังเนื้อหาที่เลือก และเชื่อมโยงกับงานใหม่
- แจ้งให้ครูทราบว่าสร้างงานเรียบร้อยแล้ว
การดำเนินการแต่ละอย่างมีอธิบายไว้ในส่วนต่อไปนี้
ตรวจสอบว่าผู้ใช้สามารถสร้างไฟล์แนบของส่วนเสริมได้หรือไม่
คุณสามารถสร้างไฟล์แนบของส่วนเสริมในนามของผู้ใช้ที่มีสิทธิ์ได้ ผู้ใช้ที่มีสิทธิ์คือผู้ใช้ที่เป็นครูในหลักสูตรที่คุณพยายามสร้างงานในหลักสูตรและได้รับใบอนุญาตรุ่น Teaching and Learning หรือ Education Plus Google Workspace for Education ดังกล่าว
เริ่มต้นด้วยการพิจารณาว่าผู้ใช้จะสร้างส่วนเสริมใน Course
ที่ระบุได้หรือไม่
ส่งคำขอไปยังปลายทาง courses.checkAddOnCreationEligibility
รวมถึงรหัสหลักสูตร
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
ใหม่โดยให้มี URL เนื้อหาที่ผู้ใช้เลือกเป็น 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
ใหม่โดยไม่มีไฟล์แนบ - สร้างไฟล์แนบของส่วนเสริม
- ตั้งค่า
itemId
ของAddOnAttachment
เป็น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")}'
)
ส่วนเสริมจะปรากฏเป็นการ์ดไฟล์แนบใน Classroom URL ที่ระบุในคำขอจะเปิดใน iframe สำหรับข้อมูลพร็อพเพอร์ตี้แต่ละรายการที่เหมาะสม