Method: courses.courseWork.patch

कोर्स वर्क के एक या उससे ज़्यादा फ़ील्ड अपडेट करता है.

कौनसे फ़ील्ड अपडेट हो सकते हैं और उनमें कौन बदलाव कर सकता है, इस बारे में जानने के लिए google.classroom.v1.CourseWork पर जाएं.

यह अनुरोध OAuth क्लाइंट आईडी के Developer Console प्रोजेक्ट से किया जाना चाहिए, जिसका इस्तेमाल, संबंधित कोर्स वर्क आइटम बनाने के लिए किया जाता है.

इस तरीके से गड़बड़ी के ये कोड दिखते हैं:

  • PERMISSION_DENIED, अगर अनुरोध करने वाले डेवलपर प्रोजेक्ट ने उससे जुड़ा कोर्स वर्क नहीं बनाया हो, उपयोगकर्ता को छात्र/छात्रा के असाइनमेंट में बदलाव करने या ऐक्सेस से जुड़ी गड़बड़ियों के लिए अनुरोध करने की अनुमति न हो.
  • अगर अनुरोध में गड़बड़ी है, तो INVALID_ARGUMENT.
  • FAILED_PRECONDITION, अगर अनुरोध किया गया कोर्स वर्क पहले ही मिटा दिया गया है.
  • अगर अनुरोध किया गया कोर्स या कोर्स वर्क मौजूद नहीं है, तो NOT_FOUND.

एचटीटीपी अनुरोध

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
courseId

string

कोर्स का आइडेंटिफ़ायर. यह आइडेंटिफ़ायर, Classroom से असाइन किया गया कोई आइडेंटिफ़ायर या alias हो सकता है.

id

string

कोर्स वर्क का आइडेंटिफ़ायर.

क्वेरी पैरामीटर

पैरामीटर
updateMask

string (FieldMask format)

मास्क जो पहचान करता है कि कोर्स पर किन फ़ील्ड को अपडेट करना है. अपडेट करने के लिए, यह फ़ील्ड ज़रूरी है. अमान्य फ़ील्ड दिए जाने पर अपडेट नहीं होता. अगर किसी फ़ील्ड में खाली वैल्यू दी गई हैं, तो इसे CourseWork ऑब्जेक्ट में नहीं, बल्कि अपडेट मास्क में बताकर मिटाया जा सकता है. अगर कोई फ़ील्ड खाली वैल्यू के साथ काम नहीं करता, जिसे अपडेट मास्क में शामिल किया जाता है और उसे CourseWork ऑब्जेक्ट में सेट नहीं किया जाता है, तो INVALID_ARGUMENT गड़बड़ी दिखती है.

शिक्षक इन फ़ील्ड को चुन सकते हैं:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId V1_20240401_PREVIEW और उसके बाद के वर्शन में उपलब्ध है.

यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नाम की सूची है, जिसे कॉमा लगाकर अलग किया गया है. उदाहरण: "user.displayName,photo".

previewVersion

enum (PreviewVersion)

ज़रूरी नहीं. एपीआई का झलक वाला वर्शन. 'झलक देखें' कार्यक्रम में डेवलपर को उपलब्ध कराई गई एपीआई की नई सुविधाओं को ऐक्सेस करने के लिए, इसे सेट करना ज़रूरी है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में CourseWork का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में CourseWork का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/classroom.coursework.students

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.