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

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