Google Classroom के बाहर अटैचमेंट बनाना

इस गाइड में, आपकी वेबसाइट या ऐप्लिकेशन में ऐड-ऑन अटैचमेंट बनाने के बारे में बताया गया है. इंटरैक्शन कोर्स एपीआई का इस्तेमाल करके असाइनमेंट बनाने के जैसा है एंडपॉइंट. उपयोगकर्ताओं को ऐड-ऑन अटैचमेंट बनाने की अनुमति देने के लिए, यह प्रोसेस लागू करें Google Analytics 4 प्रॉपर्टी ऐक्सेस करें.

वर्कफ़्लो

बड़े लेवल पर, अटैचमेंट बनाने का सफ़र इस क्रम के बाद होता है:

  1. जब कोई शिक्षक आपकी वेबसाइट या ऐप्लिकेशन खोलता है. वे कॉन्टेंट का एक हिस्सा चुनते हैं, ताकि असाइन कर सकते हैं.
  2. यह जांचें कि उपयोगकर्ता ऐड-ऑन अटैचमेंट बना सकता है.
  3. अगर उपयोगकर्ता ऐड-ऑन अटैचमेंट नहीं बना सकता है, तो कोर्सवर्क बनाएं असाइनमेंट को लिंक सामग्री के रूप में चुने गए कॉन्टेंट के यूआरएल के साथ सबमिट करते हैं.
  4. अगर उपयोगकर्ता ऐड-ऑन अटैचमेंट बना सकता है, तो ये काम करें:
    1. असाइनमेंट बनाएं.
    2. एक ऐड-ऑन अटैचमेंट बनाएं, जो चुने गए कॉन्टेंट से लिंक हो और इसे नए असाइनमेंट से जोड़ें.
  5. शिक्षक को बताएं कि असाइनमेंट बना दिया गया है.

हर कार्रवाई के बारे में नीचे दिए गए सेक्शन में बताया गया है.

यह देखना कि कोई उपयोगकर्ता ऐड-ऑन अटैचमेंट बना सकता है या नहीं

ज़रूरी शर्तें पूरी करने वाले किसी उपयोगकर्ता की ओर से, ऐड-ऑन अटैचमेंट बनाए जा सकते हैं. ज़रूरी शर्तें पूरी करने वाला उपयोगकर्ता का मतलब है, जो उस कोर्स में शिक्षक है जिसे आपको बनाना है और में TeacherWork असाइनमेंट 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 बनाएं असाइनमेंट में सबमिट किए गए कॉन्टेंट को, उपयोगकर्ता के चुने गए कॉन्टेंट यूआरएल के तौर पर सबमिट करेगा.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 असाइनमेंट बनाएं.
  2. ऐड-ऑन अटैचमेंट बनाएं.

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 में अटैचमेंट कार्ड के तौर पर दिखता है. यूआरएल अनुरोध में बताया गया है, जो उचित में खुला है हर व्यू के लिए iframe.