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