تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
إرسال ملاحظات
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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض .
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
هل تريد مشاركة ملاحظاتك معنا؟
{"lastModified": "\u062a\u0627\u0631\u064a\u062e \u0627\u0644\u062a\u0639\u062f\u064a\u0644 \u0627\u0644\u0623\u062e\u064a\u0631: 2024-09-05 (\u062d\u0633\u0628 \u0627\u0644\u062a\u0648\u0642\u064a\u062a \u0627\u0644\u0639\u0627\u0644\u0645\u064a \u0627\u0644\u0645\u062a\u0641\u0651\u064e\u0642 \u0639\u0644\u064a\u0647)"}
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"]]