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

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

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

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

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

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

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

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

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

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