Method: courses.list

কোর্সের একটি তালিকা ফেরত দেয় যেগুলি অনুরোধকারী ব্যবহারকারীকে দেখার অনুমতি দেওয়া হয়েছে, অনুরোধের সাথে মেলে সেগুলির জন্য সীমাবদ্ধ৷ প্রত্যাবর্তিত কোর্সগুলি তৈরির সময় অনুসারে অর্ডার করা হয়, সবচেয়ে সম্প্রতি তৈরি করা প্রথমে আসে।

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

  • অ্যাক্সেস ত্রুটির জন্য PERMISSION_DENIED ।
  • INVALID_ARGUMENT যদি ক্যোয়ারী আর্গুমেন্ট ত্রুটিপূর্ণ হয়।
  • NOT_FOUND যদি ক্যোয়ারী আর্গুমেন্টে নির্দিষ্ট কোনো ব্যবহারকারীর অস্তিত্ব না থাকে।

HTTP অনুরোধ

GET https://classroom.googleapis.com/v1/courses

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

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

পরামিতি
studentId

string

নির্দিষ্ট শনাক্তকারীর সাথে ছাত্রদের জন্য ফিরে আসা কোর্সগুলিকে সীমাবদ্ধ করে। শনাক্তকারী নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

  • ব্যবহারকারীর জন্য সংখ্যাসূচক শনাক্তকারী
  • ব্যবহারকারীর ইমেল ঠিকানা
  • স্ট্রিং আক্ষরিক "me" , অনুরোধকারী ব্যবহারকারীকে নির্দেশ করে
teacherId

string

নির্দিষ্ট শনাক্তকারী সহ শিক্ষক থাকা ব্যক্তিদের জন্য ফিরে আসা কোর্সগুলিকে সীমাবদ্ধ করে৷ শনাক্তকারী নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

  • ব্যবহারকারীর জন্য সংখ্যাসূচক শনাক্তকারী
  • ব্যবহারকারীর ইমেল ঠিকানা
  • স্ট্রিং আক্ষরিক "me" , অনুরোধকারী ব্যবহারকারীকে নির্দেশ করে
courseStates[]

enum ( CourseState )

প্রত্যাবর্তিত কোর্সগুলি নির্দিষ্ট রাজ্যগুলির মধ্যে একটিতে সীমাবদ্ধ করে৷ ডিফল্ট মান হল সক্রিয়, সংরক্ষণাগারভুক্ত, প্রবিধান, প্রত্যাখ্যান৷

pageSize

integer

ফেরত দিতে আইটেম সর্বোচ্চ সংখ্যা. শূন্য বা অনির্দিষ্ট নির্দেশ করে যে সার্ভার সর্বোচ্চ বরাদ্দ করতে পারে।

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

pageToken

string

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

list অনুরোধটি অন্যথায় এই টোকেনটির ফলে অনুরূপ হতে হবে।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

কোর্স তালিকা করার সময় প্রতিক্রিয়া.

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

JSON প্রতিনিধিত্ব
{
  "courses": [
    {
      object (Course)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
courses[]

object ( Course )

তালিকা অনুরোধ মেলে যে কোর্স.

nextPageToken

string

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

অনুমোদনের সুযোগ

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

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

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