Method: courses.announcements.list

অনুরোধকারীকে দেখার অনুমতি দেওয়া ঘোষণাগুলির একটি তালিকা প্রদান করে৷

কোর্সের শিক্ষার্থীরা শুধুমাত্র PUBLISHED ঘোষণা দেখতে পারে। কোর্সের শিক্ষক এবং ডোমেন প্রশাসকরা সমস্ত ঘোষণা দেখতে পারেন।

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

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

HTTP অনুরোধ

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

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

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

পরামিতি
courseId

string

কোর্সের শনাক্তকারী। এই শনাক্তকারীটি হয় Classroom-এ নির্ধারিত শনাক্তকারী বা একটি alias হতে পারে।

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

পরামিতি
announcementStates[]

enum ( AnnouncementState )

ঘোষণার state সীমাবদ্ধতা ফিরে এসেছে। যদি এই যুক্তিটি অনির্দিষ্ট রেখে দেওয়া হয়, ডিফল্ট মান PUBLISHED হয়।

orderBy

string

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

pageSize

integer

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

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

pageToken

string

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

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

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

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

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

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

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

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

object ( Announcement )

অনুরোধের সাথে মেলে এমন ঘোষণা আইটেম।

nextPageToken

string

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

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

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

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

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