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

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

কর্মপ্রবাহ

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

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

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

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

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

ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে পারে কিনা তা নির্ধারণ করে শুরু করুন। আপনি CREATE_ADD_ON_ATTACHMENT সক্ষমতা প্যারামিটার সহ userProfiles.checkUserCapability এন্ডপয়েন্টে একটি অনুরোধ জারি করে তা করতে পারেন। প্রতিক্রিয়ায় বুলিয়ান 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(f'User eligibility for course {course_id}'
      f': {is_create_attachment_eligible}.')

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

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

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

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

পাইথন

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গুলি প্রতিটি ভিউয়ের জন্য উপযুক্ত আইফ্রেমে খোলে।