Method: courses.patch

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

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

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
id

string

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

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

पैरामीटर
updateMask

string (FieldMask format)

ऐसा मास्क जो कोर्स के किन फ़ील्ड को अपडेट करने की पहचान करता है. अपडेट करने के लिए यह फ़ील्ड ज़रूरी है. अगर फ़ील्ड अमान्य हैं, तो अपडेट नहीं हो पाएगा. ये फ़ील्ड मान्य हैं:

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

ध्यान दें: ownerId में मौजूद पैच तुरंत लागू हो जाते हैं, लेकिन असल में सभी संसाधनों के मालिकाना हक के ट्रांसफ़र को पूरा होने में कुछ समय लग सकता है.

क्वेरी पैरामीटर में सेट करने पर, यह फ़ील्ड इस तरह बताया जाना चाहिए

updateMask=<field1>,<field2>,...

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

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

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

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

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

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

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

  • https://www.googleapis.com/auth/classroom.courses

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