Method: courses.topics.patch

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
courseId

string

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

string

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

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

पैरामीटर
updateMask

string (FieldMask format)

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

इन फ़ील्ड की जानकारी दी जा सकती है:

  • name

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

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

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

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

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

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

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

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

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