Method: courses.courseWorkMaterials.list

কোর্সওয়ার্ক উপকরণের একটি তালিকা ফেরত দেয়, যা অনুরোধকারী দেখার অনুমতিপ্রাপ্ত।

কোর্সের শিক্ষার্থীরা শুধুমাত্র PUBLISHED কোর্সওয়ার্ক সামগ্রী দেখতে পারবেন। কোর্সের শিক্ষক এবং ডোমেইন প্রশাসকগণ সকল কোর্সওয়ার্ক সামগ্রী দেখতে পারবেন।

এই পদ্ধতিটি নিম্নলিখিত ত্রুটি কোডগুলি ফেরত দেয়:

  • অনুরোধকারী ব্যবহারকারীর অনুরোধকৃত কোর্সটিতে প্রবেশ করার অনুমতি না থাকলে অথবা প্রবেশে কোনো ত্রুটি হলে PERMISSION_DENIED ।
  • অনুরোধটি ত্রুটিপূর্ণ হলে INVALID_ARGUMENT হবে।
  • অনুরোধকৃত কোর্সটি বিদ্যমান না থাকলে NOT_FOUND ।

HTTP অনুরোধ

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

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
courseId

string

কোর্সের শনাক্তকারী। এই শনাক্তকারীটি ক্লাসরুম-নির্ধারিত শনাক্তকারী অথবা একটি alias হতে পারে।

কোয়েরি প্যারামিটার

প্যারামিটার
courseWorkMaterialStates[]

enum ( CourseWorkMaterialState )

ফেরত দেওয়ার জন্য কাজের স্থিতির উপর বিধিনিষেধ রয়েছে। শুধুমাত্র মিলে যাওয়া কোর্সওয়ার্ক সামগ্রীই ফেরত দেওয়া হয়। যদি অনির্দিষ্ট থাকে, তবে 'প্রকাশিত PUBLISHED স্থিতিযুক্ত আইটেমগুলি ফেরত দেওয়া হয়।

orderBy

string

ফলাফলের জন্য ঐচ্ছিক সাজানোর ক্রম। ঐচ্ছিক সাজানোর দিক নির্দেশক কীওয়ার্ড সহ ফিল্ডগুলির একটি কমা-দ্বারা-বিভক্ত তালিকা। সমর্থিত ফিল্ড হলো updateTime । সমর্থিত দিক নির্দেশক কীওয়ার্ডগুলো হলো asc এবং desc । যদি নির্দিষ্ট না করা হয়, তাহলে updateTime desc হলো ডিফল্ট আচরণ। উদাহরণ: updateTime asc , updateTime

pageSize

integer

ফেরতযোগ্য আইটেমের সর্বোচ্চ সংখ্যা। শূন্য বা অনির্দিষ্ট থাকলে বোঝা যায় যে, সার্ভার একটি সর্বোচ্চ সংখ্যা নির্ধারণ করে দিতে পারে।

সার্ভার নির্দিষ্ট সংখ্যার চেয়ে কম ফলাফল ফেরত দিতে পারে।

pageToken

string

পূর্ববর্তী list কল থেকে ফেরত আসা nextPageToken মান, যা নির্দেশ করে যে ফলাফলের পরবর্তী পৃষ্ঠাটি ফেরত দেওয়া উচিত।

list অনুরোধটি অবশ্যই সেই অনুরোধের সাথে অন্যথায় অভিন্ন হতে হবে যার ফলে এই টোকেনটি তৈরি হয়েছে।

materialDriveId

string

কোর্সওয়ার্ক উপকরণের জন্য ঐচ্ছিক ফিল্টারিং, যেখানে অন্তত একটি ড্রাইভ উপকরণের আইডি প্রদত্ত স্ট্রিংয়ের সাথে মিলতে হবে। যদি materialLink ও নির্দিষ্ট করা থাকে, তবে কোর্সওয়ার্ক উপকরণে অবশ্যই উভয় ফিল্টারের সাথে মেলে এমন উপকরণ থাকতে হবে।

previewVersion

enum ( PreviewVersion )

ঐচ্ছিক। এপিআই-এর প্রিভিউ সংস্করণ। প্রিভিউ প্রোগ্রামে ডেভেলপারদের জন্য উপলব্ধ করা নতুন এপিআই সক্ষমতাগুলো অ্যাক্সেস করার জন্য এটি অবশ্যই সেট করতে হবে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

কোর্সওয়ার্কের উপকরণ তালিকাভুক্ত করার সময় প্রতিক্রিয়া।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "courseWorkMaterial": [
    {
      object (CourseWorkMaterial)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
courseWorkMaterial[]

object ( CourseWorkMaterial )

অনুরোধের সাথে মেলে এমন কোর্সওয়ার্কের উপকরণসমূহ।

nextPageToken

string

পরবর্তী ফলাফল পৃষ্ঠা শনাক্তকারী টোকেন। এটি খালি থাকলে, আর কোনো ফলাফল পাওয়া যাবে না।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/classroom.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।