গুগল ক্লাসরুমের বাইরে সংযুক্তি তৈরি করুন

এই নির্দেশিকাটি আপনার ওয়েবসাইট বা অ্যাপ্লিকেশনে অ্যাড-অন সংযুক্তি তৈরি করার ঠিকানা। ইন্টারঅ্যাকশনগুলি CourseWork API এন্ডপয়েন্ট ব্যবহার করে অ্যাসাইনমেন্ট তৈরি করার মতো। ব্যবহারকারীদের আপনার ওয়েবসাইট বা অ্যাপ্লিকেশন থেকে অ্যাড-অন সংযুক্তি তৈরি করার অনুমতি দেওয়ার জন্য এই যাত্রাটি বাস্তবায়ন করুন।

কর্মপ্রবাহ

একটি উচ্চ স্তরে, সংযুক্তি তৈরির যাত্রা এই ক্রম অনুসরণ করে:

1. একজন শিক্ষক ব্যবহারকারী আপনার ওয়েবসাইট বা অ্যাপ খোলেন। তারা তাদের শিক্ষার্থীদের বরাদ্দ করার জন্য সামগ্রীর একটি অংশ নির্বাচন করে।
2. ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে পারেন কিনা পরীক্ষা করুন ।
3. ব্যবহারকারী যদি অ্যাড-অন সংযুক্তি তৈরি করতে না পারেন , তাহলে লিঙ্ক উপাদান হিসেবে নির্বাচিত বিষয়বস্তুর URL সহ একটি কোর্সওয়ার্ক অ্যাসাইনমেন্ট তৈরি করুন৷
4. ব্যবহারকারী যদি অ্যাড-অন সংযুক্তি তৈরি করতে পারেন , তাহলে নিম্নলিখিতগুলি করুন:
   1. একটি অ্যাসাইনমেন্ট তৈরি করুন।
   2. একটি অ্যাড-অন সংযুক্তি তৈরি করুন যা নির্বাচিত সামগ্রীর সাথে লিঙ্ক করে এবং এটিকে নতুন অ্যাসাইনমেন্টের সাথে সংযুক্ত করে৷
5. শিক্ষককে জানান যে অ্যাসাইনমেন্টটি সফলভাবে তৈরি করা হয়েছে।

প্রতিটি কর্ম নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে.

একজন ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে পারে কিনা তা পরীক্ষা করুন

আপনি একজন যোগ্য ব্যবহারকারীর পক্ষে অ্যাড-অন সংযুক্তি তৈরি করতে পারেন। একজন যোগ্য ব্যবহারকারী হলেন একজন ব্যবহারকারী যিনি আপনি যে কোর্সে CourseWork অ্যাসাইনমেন্ট তৈরি করার চেষ্টা করছেন সেই কোর্সের একজন শিক্ষক এবং তাদের কাছে Teaching & Learning বা Education Plus Google Workspace for Education সংস্করণের লাইসেন্স রয়েছে।

ব্যবহারকারী একটি প্রদত্ত Course অ্যাড-অন তৈরি করতে পারে কিনা তা নির্ধারণ করে শুরু করুন। কোর্স আইডি সহ courses.checkAddOnCreationEligibility এন্ডপয়েন্টে একটি অনুরোধ জারি করুন।

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 বুলিয়ান ফেরত দেবে না।

ব্যবহারকারীকে তাদের যোগ্যতার ভিত্তিতে রুট করুন

আপনি একজন ব্যবহারকারীর জন্য অ্যাড-অন সংযুক্তি তৈরি করতে পারবেন কিনা তা নির্ধারণ করে।

অযোগ্য ব্যবহারকারী

ব্যবহারকারী যদি অ্যাড-অন অ্যাটাচমেন্ট তৈরি করতে না পারেন , তাহলে Link হিসেবে ব্যবহারকারী-নির্বাচিত কন্টেন্ট URL দিয়ে একটি নতুন 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 ক্লিক করতে পারেন।

চিত্র 1. লিঙ্ক উপাদান সহ একটি খসড়া কোর্সওয়ার্ক অ্যাসাইনমেন্টের শিক্ষকের দৃষ্টিভঙ্গি।

যোগ্য ব্যবহারকারী

ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে পারলে নিম্নলিখিতগুলি করুন৷

1. কোনো সংযুক্তি ছাড়াই একটি নতুন CourseWork অ্যাসাইনমেন্ট তৈরি করুন।
2. একটি অ্যাড-অন সংযুক্তি তৈরি করুন।
   • নতুন তৈরি অ্যাসাইনমেন্টের id AddOnAttachment এর itemId সেট করুন।
   • নিশ্চিত করুন যে আপনি সমর্থন করেন এমন প্রতিটি ভিউয়ের জন্য ব্যবহারকারী-নির্বাচিত বিষয়বস্তুর 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গুলি প্রতিটি ভিউয়ের জন্য উপযুক্ত আইফ্রেমে খোলে।

এই নির্দেশিকাটি আপনার ওয়েবসাইট বা অ্যাপ্লিকেশনে অ্যাড-অন সংযুক্তি তৈরি করার ঠিকানা। ইন্টারঅ্যাকশনগুলি CourseWork API এন্ডপয়েন্ট ব্যবহার করে অ্যাসাইনমেন্ট তৈরি করার মতো। ব্যবহারকারীদের আপনার ওয়েবসাইট বা অ্যাপ্লিকেশন থেকে অ্যাড-অন সংযুক্তি তৈরি করার অনুমতি দেওয়ার জন্য এই যাত্রাটি বাস্তবায়ন করুন।

কর্মপ্রবাহ

একটি উচ্চ স্তরে, সংযুক্তি তৈরির যাত্রা এই ক্রম অনুসরণ করে:

1. একজন শিক্ষক ব্যবহারকারী আপনার ওয়েবসাইট বা অ্যাপ খোলেন। তারা তাদের শিক্ষার্থীদের বরাদ্দ করার জন্য সামগ্রীর একটি অংশ নির্বাচন করে।
2. ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে পারেন কিনা পরীক্ষা করুন ।
3. ব্যবহারকারী যদি অ্যাড-অন সংযুক্তি তৈরি করতে না পারেন , তাহলে লিঙ্ক উপাদান হিসেবে নির্বাচিত বিষয়বস্তুর URL সহ একটি কোর্সওয়ার্ক অ্যাসাইনমেন্ট তৈরি করুন৷
4. ব্যবহারকারী যদি অ্যাড-অন সংযুক্তি তৈরি করতে পারেন , তাহলে নিম্নলিখিতগুলি করুন:
   1. একটি অ্যাসাইনমেন্ট তৈরি করুন।
   2. একটি অ্যাড-অন সংযুক্তি তৈরি করুন যা নির্বাচিত সামগ্রীর সাথে লিঙ্ক করে এবং এটিকে নতুন অ্যাসাইনমেন্টের সাথে সংযুক্ত করে৷
5. শিক্ষককে জানান যে অ্যাসাইনমেন্টটি সফলভাবে তৈরি করা হয়েছে।

প্রতিটি কর্ম নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে.

একজন ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে পারে কিনা তা পরীক্ষা করুন

আপনি একজন যোগ্য ব্যবহারকারীর পক্ষে অ্যাড-অন সংযুক্তি তৈরি করতে পারেন। একজন যোগ্য ব্যবহারকারী হলেন একজন ব্যবহারকারী যিনি আপনি যে কোর্সে CourseWork অ্যাসাইনমেন্ট তৈরি করার চেষ্টা করছেন সেই কোর্সের একজন শিক্ষক এবং তাদের কাছে Teaching & Learning বা Education Plus Google Workspace for Education সংস্করণের লাইসেন্স রয়েছে।

ব্যবহারকারী একটি প্রদত্ত Course অ্যাড-অন তৈরি করতে পারে কিনা তা নির্ধারণ করে শুরু করুন। কোর্স আইডি সহ courses.checkAddOnCreationEligibility এন্ডপয়েন্টে একটি অনুরোধ জারি করুন।

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 বুলিয়ান ফেরত দেবে না।

ব্যবহারকারীকে তাদের যোগ্যতার ভিত্তিতে রুট করুন

আপনি একজন ব্যবহারকারীর জন্য অ্যাড-অন সংযুক্তি তৈরি করতে পারবেন কিনা তা নির্ধারণ করে।

অযোগ্য ব্যবহারকারী

ব্যবহারকারী যদি অ্যাড-অন অ্যাটাচমেন্ট তৈরি করতে না পারেন , তাহলে Link হিসেবে ব্যবহারকারী-নির্বাচিত কন্টেন্ট URL দিয়ে একটি নতুন 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 ক্লিক করতে পারেন।

চিত্র 1. লিঙ্ক উপাদান সহ একটি খসড়া কোর্সওয়ার্ক অ্যাসাইনমেন্টের শিক্ষকের দৃষ্টিভঙ্গি।

যোগ্য ব্যবহারকারী

ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে পারলে নিম্নলিখিতগুলি করুন৷

1. কোনো সংযুক্তি ছাড়াই একটি নতুন CourseWork অ্যাসাইনমেন্ট তৈরি করুন।
2. একটি অ্যাড-অন সংযুক্তি তৈরি করুন।
   • নতুন তৈরি অ্যাসাইনমেন্টের id AddOnAttachment এর itemId সেট করুন।
   • নিশ্চিত করুন যে আপনি সমর্থন করেন এমন প্রতিটি ভিউয়ের জন্য ব্যবহারকারী-নির্বাচিত বিষয়বস্তুর 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গুলি প্রতিটি ভিউয়ের জন্য উপযুক্ত আইফ্রেমে খোলে।