Method: courses.courseWork.patch

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

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

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

यह तरीका, गड़बड़ी के ये कोड दिखाता है:

  • 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
  • learningGoals

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

enum (PreviewVersion)

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

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

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

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

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

अनुमति पाने के लिंक

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

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

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