تعرض قائمة بالإعلانات التي يُسمح لمقدّم الطلب بالاطّلاع عليها.
يمكن لطلاب الدورة التدريبية عرض PUBLISHED
إشعار فقط. يمكن لمعلّمي الدورة التدريبية ومشرفي النطاق الاطّلاع على جميع الإشعارات.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بالوصول إلى الدورة التدريبية المطلوبة أو بسبب أخطاء في الوصول.INVALID_ARGUMENT
إذا كان الطلب مكتوبًا بشكلٍ غير صحيح.NOT_FOUND
إذا لم تكن الدورة التدريبية المطلوبة متوفّرة.
طلب HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
courseId |
معرّف الدورة التدريبية. ويمكن أن يكون هذا المعرّف إمّا المعرّف الذي حدّده Classroom أو |
معلمات طلب البحث
المَعلمات | |
---|---|
announcementStates[] |
يتم فرض قيود على |
orderBy |
ترتيب اختياري للنتائج قائمة حقول مفصولة بفواصل مع كلمة رئيسية اختيارية لتوجيه الترتيب. الحقل المتاح هو |
pageSize |
الحدّ الأقصى لعدد السلع المطلوب إرجاعها يشير الخيار "صفر" أو "غير محدّد" إلى أنّ الخادم قد يعيّن حدًّا أقصى. قد يعرض الخادم عددًا أقل من عدد النتائج المحدّد. |
pageToken |
تم عرض قيمة ويجب أن يكون طلب |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رد عند إدراج عمل الدورة الدراسية.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"announcements": [
{
object ( |
الحقول | |
---|---|
announcements[] |
الإعلان عن السلع التي تطابق الطلب |
nextPageToken |
رمز مميز يحدد الصفحة التالية من النتائج المطلوب عرضها إذا كان هذا الحقل فارغًا، لن يتم توفير أي نتائج أخرى. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/classroom.announcements
https://www.googleapis.com/auth/classroom.announcements.readonly
لمزيد من المعلومات، راجِع دليل التفويض.