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

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