Method: courses.topics.patch

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

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

  • PERMISSION_DENIED, अगर अनुरोध करने वाले डेवलपर प्रोजेक्ट से मिलता-जुलता विषय या ऐक्सेस से जुड़ी गड़बड़ियों के लिए अनुरोध न किया गया हो.
  • INVALID_ARGUMENT, अगर अनुरोध गलत तरीके से किया गया है.
  • अगर अनुरोध किया गया कोर्स या विषय मौजूद न हो, तो NOT_FOUND

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

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

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

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

पैरामीटर
courseId

string

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

string

विषय का आइडेंटिफ़ायर.

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

पैरामीटर
updateMask

string (FieldMask format)

मास्क, जो पहचान करता है कि विषय के किन फ़ील्ड को अपडेट करना है. अपडेट करने के लिए यह फ़ील्ड ज़रूरी है. अमान्य फ़ील्ड दिए गए हैं, तो अपडेट नहीं हो पाता. अगर किसी फ़ील्ड में खाली वैल्यू काम करती है, तो उसे अपडेट मास्क में तय करके साफ़ किया जा सकता है, न कि 'विषय' ऑब्जेक्ट में. अगर अपडेट मास्क में, खाली वैल्यू के साथ काम न करने वाला फ़ील्ड शामिल हो और उसे विषय ऑब्जेक्ट में सेट न किया गया हो, तो INVALID_ARGUMENT गड़बड़ी दिखती है.

नीचे दिए गए फ़ील्ड में जानकारी दी जा सकती है:

  • name

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

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

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

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

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

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

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

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

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