Method: courses.posts.addOnAttachments.list

पोस्ट के नीचे, किसी ऐड-ऑन से बनाए गए सभी अटैचमेंट दिखाता है.

पोस्ट पर चालू अटैचमेंट का ऐड-ऑन होना ज़रूरी है. इसके अलावा, पोस्ट पर नए अटैचमेंट बनाने की अनुमति भी होनी चाहिए.

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

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

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

GET https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments

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

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

पैरामीटर
courseId

string

ज़रूरी है. कोर्स का आइडेंटिफ़ायर.

postId
(deprecated)

string

ज़रूरी नहीं. कोर्स के तहत आने वाले उस पोस्ट का आइडेंटिफ़ायर जिसके अटैचमेंट की गिनती करनी है. अब काम नहीं करता, इसके बजाय itemId का इस्तेमाल करें.

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

पैरामीटर
itemId

string

उस सूचना, CourseWork या CourseWorkMaterial का आइडेंटिफ़ायर जिसके अटैचमेंट की गिनती की जानी चाहिए. यह फ़ील्ड ज़रूरी है, लेकिन पोस्ट आईडी से माइग्रेट करते समय इसे इस तरह मार्क नहीं किया गया है.

pageSize

integer

लौटाए जाने वाले अटैचमेंट की ज़्यादा से ज़्यादा संख्या. सेवा, इस वैल्यू से कम वैल्यू दिखा सकती है. अगर इनकी जानकारी नहीं दी जाती है, तो ज़्यादा से ज़्यादा 20 अटैचमेंट ही दिखाए जाएंगे. वैल्यू ज़्यादा से ज़्यादा 20 हो सकती है. वहीं, 20 से ज़्यादा वैल्यू को जबरन 20 कर दिया जाएगा.

pageToken

string

पिछले addOnAttachments.list कॉल से मिला पेज टोकन. अगला पेज वापस पाने के लिए यह विकल्प दें.

पेजों को पेजों में जोड़ते समय, addOnAttachments.list को दिए गए अन्य सभी पैरामीटर, उस कॉल से मेल खाने चाहिए जिससे पेज टोकन दिया गया था.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य हिस्सा

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

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

इनमें से कोई एक OAuth स्कोप ज़रूरी है:

  • https://www.googleapis.com/auth/classroom.addons.student
  • https://www.googleapis.com/auth/classroom.addons.teacher

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