Method: courses.courseWork.rubrics.list

لعرض قائمة بالعناصر التي يُسمح لمقدّم الطلب بعرضها.

تُرجع هذه الطريقة رموز الأخطاء التالية:

  • PERMISSION_DENIED لأخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب غير صالح
  • NOT_FOUND إذا لم تكن الدورة التدريبية أو العمل الدراسي المطلوبَين متوفّرين أو إذا لم يكن لدى المستخدم إذن الوصول إلى العمل الدراسي المقابل.

طلب HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
courseId

string

مطلوب. معرّف الدورة التدريبية.
courseWorkId

string

مطلوب. معرّف عمل الدورة الدراسية

مَعلمات طلب البحث

المعلمات
pageSize

integer

الحد الأقصى لعدد العناوين المراد عرضها إذا لم يتم تحديدها، يتم عرض عنوان واحد كحد أقصى. الحد الأقصى للقيمة هو 1، ويتم تحويل القيم التي تزيد عن 1 إلى 1.
pageToken

string

قيمة nextPageToken التي تم إرجاعها من طلب list سابق، ما يشير إلى أنّه يجب عرض الصفحة التالية من النتائج.

يجب أن يكون طلب list مطابقًا للطلب الذي أدّى إلى إنشاء هذا الرمز المميّز.
previewVersion

enum (PreviewVersion)

اختياريّ. إصدار المعاينة لواجهة برمجة التطبيقات. يجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة".

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الردّ عند إدراج العناوين الرئيسية

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "rubrics": [
    {
      object (Rubric)
    }
  ],
  "nextPageToken": string
}
الحقول
rubrics[]

object (Rubric)

العناوين التي تتطابق مع الطلب
nextPageToken

string

رمز مميز يحدِّد الصفحة التالية من النتائج التي سيتم عرضها. إذا كان الحقل فارغًا، لن تتوفّر أي نتائج أخرى.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.