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

لمزيد من المعلومات، راجِع دليل التفويض.