Method: courses.courseWork.list

कोर्स वर्क की वह सूची दिखाता है जिसे अनुरोध करने वाले को देखने की अनुमति है.

कोर्स के छात्र-छात्राएं, सिर्फ़ PUBLISHED कोर्स वर्क देख सकते हैं. कोर्स के शिक्षक और डोमेन एडमिन, सभी कोर्स वर्क देख सकते हैं.

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

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

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

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork

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

पाथ पैरामीटर

पैरामीटर
courseId

string

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

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

पैरामीटर
courseWorkStates[]

enum (CourseWorkState)

लौटाने के लिए काम की स्थिति पर पाबंदी. सिर्फ़ मिलता-जुलता टेक्स्ट ही दिखाया जाता है. अगर इसकी जानकारी नहीं दी गई है, तो ऐसे आइटम लौटाए जाते हैं जिनके काम की स्थिति PUBLISHED है.
orderBy

string

नतीजों को क्रम से लगाने का विकल्प उपलब्ध होना ज़रूरी नहीं है. क्रम से लगाने की दिशा वाला वैकल्पिक कीवर्ड के साथ, फ़ील्ड की कॉमा-सेपरेटेड लिस्ट. updateTime और dueDate फ़ील्ड का इस्तेमाल किया जा सकता है. asc और desc दिशा वाले कीवर्ड का इस्तेमाल किया जा सकता है. अगर इसके बारे में नहीं बताया गया है, तो updateTime desc डिफ़ॉल्ट तरीका है. उदाहरण: dueDate asc,updateTime desc, updateTime,dueDate desc
pageSize

integer

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

सर्वर, तय की गई संख्या से कम नतीजे दिखा सकता है.
pageToken

string

पिछले list कॉल से मिली nextPageToken वैल्यू. इससे पता चलता है कि नतीजों का अगला पेज दिखाया जाना चाहिए.

list अनुरोध, इस टोकन में मिले अनुरोध के जैसा होना चाहिए.
previewVersion

enum (PreviewVersion)

ज़रूरी नहीं. एपीआई का झलक वाला वर्शन. 'झलक देखें' कार्यक्रम में डेवलपर को उपलब्ध कराई गई एपीआई की नई सुविधाओं को ऐक्सेस करने के लिए, इसे सेट करना ज़रूरी है.

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

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

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

कोर्स वर्क की सूची बनाते समय जवाब दें.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "courseWork": [
    {
      object (CourseWork)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
courseWork[]

object (CourseWork)

कोर्स वर्क के वे आइटम जो अनुरोध से मेल खाते हैं.
nextPageToken

string

टोकन, जो दिखाए जाने वाले नतीजों के अगले पेज की पहचान करता है. अगर यह फ़ील्ड खाली है, तो कोई और नतीजा नहीं मिलेगा.

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

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

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

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