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

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

গুরুত্বপূর্ণ: আপনি যদি ইতিমধ্যেই CourseWork অ্যাসাইনমেন্ট তৈরি করে থাকেন তাহলে আমরা এই সংযুক্তি তৈরির প্রবাহটি বাস্তবায়নের জন্য দৃঢ়ভাবে সুপারিশ করছি। একটি CourseWork বাস্তবায়ন প্রসারিত করা আপনাকে আরও অনেক ব্যবহারকারীকে আপনার অ্যাড-অনে রূপান্তর করতে দেয় এবং সামান্য অতিরিক্ত কাজের প্রয়োজন হয়।

কর্মপ্রবাহ

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

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

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

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

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

মূল পয়েন্ট: অ্যাড-অন সংযুক্তি তৈরি করার যোগ্যতা প্রতিটি ব্যবহারকারীর জন্য আলাদা হতে পারে এবং সময়ের সাথে সাথে পরিবর্তন হতে পারে। অ্যাড-অন সংযুক্তি তৈরি করার চেষ্টা করার আগে সর্বদা ব্যবহারকারীর যোগ্যতা পরীক্ষা করুন।

গুরুত্বপূর্ণ: ক্লাসরুম API ব্যবহার করে যোগ্যতা পরীক্ষা সর্বজনীন পূর্বরূপ এবং পূর্বরূপ সংস্করণ V1_20240930_PREVIEW এবং পরবর্তীতে উপলব্ধ। সর্বজনীন প্রিভিউতে API পদ্ধতি ব্যবহার করতে, আপনাকে অবশ্যই Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হতে হবে এবং সাধারণ Classroom API ব্যবহারের বাইরে অতিরিক্ত সেটআপ করতে হবে ।

ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে পারে কিনা তা নির্ধারণ করে শুরু করুন। আপনি CREATE_ADD_ON_ATTACHMENT সক্ষমতা প্যারামিটার সহ userProfiles.checkUserCapability এন্ডপয়েন্টে একটি অনুরোধ জারি করে তা করতে পারেন। প্রতিক্রিয়ায় বুলিয়ান allowed ক্ষেত্রটি পরিদর্শন করুন; একটি true মান নির্দেশ করে যে ব্যবহারকারী অ্যাড-অন সংযুক্তি তৈরি করতে যোগ্য।

সতর্কতা: CREATE_ADD_ON_ATTACHMENT সক্ষমতা সহ ব্যবহারকারীদের জন্য অ্যাড-অন সংযুক্তি তৈরি করার অনুরোধগুলি সফল হওয়ার গ্যারান্টি দেওয়া হয় না। উদাহরণ স্বরূপ, সক্ষমতা সহ একজন ব্যবহারকারী একটি 403 প্রতিক্রিয়া ত্রুটি পাবেন যদি আপনি তাদের পক্ষ থেকে অ্যাড-অন সংযুক্তি তৈরি করার চেষ্টা করেন যেখানে ব্যবহারকারী শিক্ষক নন।

পাইথন

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. একটি অ্যাড-অন সংযুক্তি তৈরি করুন।
   • নতুন তৈরি অ্যাসাইনমেন্টের 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গুলি প্রতিটি ভিউয়ের জন্য উপযুক্ত আইফ্রেমে খোলে।