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

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