Method: courses.announcements.patch

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

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

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

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

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

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

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

पैरामीटर
courseId

string

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

string

सूचना का आइडेंटिफ़ायर.

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

पैरामीटर
updateMask

string (FieldMask format)

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

नीचे दिए गए फ़ील्ड को शिक्षक तय कर सकते हैं:

  • text
  • state
  • scheduledTime

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

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

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

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

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

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

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

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

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