تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
إرسال ملاحظات
Method: userProfiles.guardianInvitations.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض قائمة بدعوات الأوصياء التي يُسمح للمستخدم مقدِّم الطلب بالاطّلاع عليها، مع فلترتها حسب المَعلمات المقدَّمة
تُرجع هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
في حال تحديد studentId
، وعدم السماح للمستخدم الذي قدّم الطلب بالاطّلاع على دعوات الأوصياء لهذا الطالب، إذا تم تحديد "-"
على أنّه studentId
ولم يكن المستخدم مشرفًا للنطاق، أو إذا لم يتم تفعيل الأوصياء في النطاق المعنيّ، أو بسبب أخطاء الوصول الأخرى.
INVALID_ARGUMENT
إذا تم تحديد studentId
، ولكن لا يمكن التعرّف على تنسيقه (ليس عنوان بريد إلكتروني، ولا studentId
من واجهة برمجة التطبيقات، ولا السلسلة الحرفية me
). قد تُرجع أيضًا إذا تم تقديم pageToken
أو state
غير صالحَين.
NOT_FOUND
إذا تم تحديد studentId
، ويمكن التعرّف على تنسيقه، ولكن ليس لدى Classroom سجلّ لهذا الطالب.
طلب HTTP
GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations
يستخدِم عنوان URL بنية تحويل ترميز gRPC .
مَعلمات المسار
المعلمات
studentId
string
رقم تعريف الطالب الذي سيتم عرض دعوات الأوصياء عليه يمكن أن يكون المعرّف واحدًا مما يلي:
المعرّف الرقمي للمستخدم
عنوان البريد الإلكتروني للمستخدم
السلسلة الحرفية "me"
، للإشارة إلى المستخدم صاحب الطلب
السلسلة الحرفية "-"
، ما يشير إلى أنّه يجب عرض النتائج لجميع الطلاب أنّ المستخدم الذي قدّم الطلب مسموح له بالاطّلاع على دعوات الأوصياء
معامِلات طلب البحث
المعلمات
invitedEmailAddress
string
وفي حال تحديدها، سيتم فقط عرض النتائج ذات السمة invitedEmailAddress
المحددة.
states[]
enum (GuardianInvitationState
)
وفي حال تحديدها، لن يتم عرض سوى النتائج ذات قيم state
المحدَّدة. وبخلاف ذلك، يتم عرض النتائج التي تحتوي على state
من PENDING
.
pageToken
string
قيمة nextPageToken
التي تم عرضها من طلب list
سابق، للإشارة إلى أنه يجب عرض صفحة النتائج اللاحقة.
يجب أن يكون طلب list
مطابقًا للطلب الذي نتج عنه هذا الرمز المميّز.
pageSize
integer
الحدّ الأقصى لعدد السلع المطلوب إرجاعها يشير "صفر" أو "غير محدَّد" إلى أنّ الخادم قد يعيّن حدًا أقصى.
قد يعرض الخادم عددًا أقل من العدد المحدّد من النتائج.
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة عند إدراج دعوات الأوصياء
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON
{
"guardianInvitations" : [
{
object (GuardianInvitation
)
}
] ,
"nextPageToken" : string
}
الحقول
guardianInvitations[]
object (GuardianInvitation
)
دعوات الأوصياء التي تطابق طلب القائمة
nextPageToken
string
رمز مميز يحدد الصفحة التالية من النتائج المطلوب عرضها. إذا كان هذا الحقل فارغًا، لن تتوفّر أي نتائج أخرى.
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
https://www.googleapis.com/auth/classroom.guardianlinks.students
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض .
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-20 (حسب التوقيت العالمي المتفَّق عليه)
[{
"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-20 (\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-20 (حسب التوقيت العالمي المتفَّق عليه)"]]