এই নির্দেশিকাটি আপনার ওয়েবসাইট বা অ্যাপ্লিকেশনে অ্যাড-অন অ্যাটাচমেন্ট তৈরি করার পদ্ধতি নিয়ে আলোচনা করে। এর কার্যপ্রণালী CourseWork API এন্ডপয়েন্ট ব্যবহার করে অ্যাসাইনমেন্ট তৈরির মতোই। ব্যবহারকারীরা যাতে আপনার ওয়েবসাইট বা অ্যাপ্লিকেশন থেকে অ্যাড-অন অ্যাটাচমেন্ট তৈরি করতে পারে, সেজন্য এই প্রক্রিয়াটি বাস্তবায়ন করুন।
কর্মপ্রবাহ
উচ্চস্তরে, সংযুক্তি তৈরির যাত্রাটি এই ক্রম অনুসরণ করে:
- একজন শিক্ষক ব্যবহারকারী আপনার ওয়েবসাইট বা অ্যাপটি খোলেন। তিনি তাঁর শিক্ষার্থীদেরকে দেওয়ার জন্য একটি বিষয়বস্তু নির্বাচন করেন।
- ব্যবহারকারী অতিরিক্ত সংযুক্তি তৈরি করতে পারেন কিনা তা যাচাই করুন ।
- যদি ব্যবহারকারী অ্যাড-অন অ্যাটাচমেন্ট তৈরি করতে না পারেন , তাহলে নির্বাচিত কন্টেন্টের URL-টিকে লিঙ্ক মেটেরিয়াল হিসেবে ব্যবহার করে একটি কোর্সওয়ার্ক অ্যাসাইনমেন্ট তৈরি করুন।
- যদি ব্যবহারকারী অ্যাড-অন অ্যাটাচমেন্ট তৈরি করতে পারেন , তাহলে নিম্নলিখিতগুলি করুন:
- একটি অ্যাসাইনমেন্ট তৈরি করুন।
- একটি অতিরিক্ত সংযুক্তি তৈরি করুন যা নির্বাচিত বিষয়বস্তুর সাথে লিঙ্ক করবে এবং এটিকে নতুন অ্যাসাইনমেন্টের সাথে যুক্ত করুন।
- শিক্ষককে জানান যে অ্যাসাইনমেন্টটি সফলভাবে তৈরি হয়েছে।
প্রতিটি পদক্ষেপ নিম্নলিখিত বিভাগগুলিতে বর্ণনা করা হয়েছে।
একজন ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে পারেন কিনা তা যাচাই করুন
আপনি একজন যোগ্য ব্যবহারকারীর পক্ষ থেকে অ্যাড-অন অ্যাটাচমেন্ট তৈরি করতে পারেন। একজন যোগ্য ব্যবহারকারী হলেন এমন একজন ব্যবহারকারী যিনি সেই কোর্সের শিক্ষক, যেটিতে আপনি কোর্সওয়ার্ক অ্যাসাইনমেন্ট তৈরি করার চেষ্টা করছেন এবং যাঁকে টিচিং অ্যান্ড লার্নিং অথবা এডুকেশন প্লাস গুগল ওয়ার্কস্পেস ফর এডুকেশন সংস্করণের লাইসেন্স বরাদ্দ করা হয়েছে।
ব্যবহারকারী অ্যাড-অন অ্যাটাচমেন্ট তৈরি করতে পারবেন কিনা, তা প্রথমে নির্ধারণ করুন। এটি করার জন্য, userProfiles.checkUserCapability এন্ডপয়েন্টে CREATE_ADD_ON_ATTACHMENT ক্যাপাবিলিটি প্যারামিটারসহ একটি রিকোয়েস্ট পাঠান। রেসপন্সের বুলিয়ান ' allowed ফিল্ডটি পরীক্ষা করুন; এর ' true ' ভ্যালু নির্দেশ করে যে ব্যবহারকারী অ্যাড-অন অ্যাটাচমেন্ট তৈরি করার যোগ্য।
পাইথন
eligibility_response = (
classroom_service.userProfiles()
.checkUserCapability(
userId="me",
capability="CREATE_ADD_ON_ATTACHMENT",
# The previewVersion is necessary while the method is available in the
# Workspace Developer Preview Program.
previewVersion="V1_20240930_PREVIEW",
).execute()
)
is_create_attachment_eligible = (
eligibility_response.get('allowed')
)
print('User eligibility for add-on attachment creation: '
f'{is_create_attachment_eligible}.')
ব্যবহারকারীকে তার যোগ্যতার ভিত্তিতে পথ দেখান।
কোনো ব্যবহারকারীর জন্য অতিরিক্ত সংযুক্তি তৈরি করা যাবে কিনা, তা তার যোগ্যতার ওপর নির্ভর করে।
অযোগ্য ব্যবহারকারী
যদি ব্যবহারকারী অ্যাড-অন অ্যাটাচমেন্ট তৈরি করতে না পারেন , তাহলে ব্যবহারকারীর নির্বাচিত কন্টেন্ট URL-টিকে Link হিসেবে ব্যবহার করে একটি নতুন CourseWork অ্যাসাইনমেন্ট তৈরি করুন।
পাইথন
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 ক্লিক করে আপনার সাইটে একটি নতুন ট্যাবে বিষয়বস্তুটি খুলতে পারেন।
চিত্র ১. লিঙ্ক উপাদানসহ একটি খসড়া কোর্সওয়ার্ক অ্যাসাইনমেন্টের শিক্ষক দৃশ্য।
যোগ্য ব্যবহারকারী
যদি ব্যবহারকারী অ্যাড-অন অ্যাটাচমেন্ট তৈরি করতে পারেন , তাহলে নিম্নলিখিতগুলি করুন।
- কোনো সংযুক্তি ছাড়া একটি নতুন
CourseWorkঅ্যাসাইনমেন্ট তৈরি করুন। - একটি অতিরিক্ত সংযুক্তি তৈরি করুন।
-
AddOnAttachmentএরitemIdনতুন তৈরি করা অ্যাসাইনমেন্টেরidসেট করুন। - আপনার সমর্থিত প্রতিটি ভিউ- এর জন্য ব্যবহারকারী-নির্বাচিত কন্টেন্টের URL প্রদান করা নিশ্চিত করুন।
-
পাইথন
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-গুলো প্রতিটি ভিউ-এর জন্য উপযুক্ত আইফ্রেমে খোলে।