فهرستی از دعوت‌نامه‌های نگهبان را که کاربر درخواست‌کننده مجاز به مشاهده آن‌ها است، با پارامترهای ارائه‌شده فیلتر می‌کند.
این روش کدهای خطای زیر را برمی گرداند:
PERMISSION_DENIED اگر studentId مشخص شده باشد، و کاربر درخواست کننده مجاز به مشاهده دعوت نامه های سرپرست برای آن دانش آموز نیست، اگر "-" به عنوان studentId مشخص شده باشد و کاربر مدیر دامنه نباشد، اگر سرپرستان برای دامنه مورد نظر فعال نشده باشند. ، یا برای سایر خطاهای دسترسی .
اگر studentId مشخص شده باشد، INVALID_ARGUMENT ، اما قالب آن قابل شناسایی نیست (این یک آدرس ایمیل، نه یک studentId از API، و نه رشته تحت اللفظی me است). همچنین در صورت ارائه pageToken یا state نامعتبر ممکن است برگردانده شود.
NOT_FOUND اگر studentId مشخص شده باشد و قالب آن قابل شناسایی باشد، اما Classroom هیچ سابقه ای از آن دانش آموز ندارد.
درخواست HTTP
GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations
تاریخ آخرین بهروزرسانی 2024-12-17 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-12-17 بهوقت ساعت هماهنگ جهانی."],[[["Returns a list of guardian invitations that the requesting user is permitted to view, filtered by the parameters provided."],["The `studentId` path parameter can be a numeric ID, email address, `\"me\"`, or `\"-\"` to retrieve invitations for all students the user has access to."],["You can filter results by `invitedEmailAddress` and `state`."],["The response includes an array of `guardianInvitations` and a `nextPageToken` for pagination."],["Requires authorization with either `classroom.guardianlinks.students.readonly` or `classroom.guardianlinks.students` scope."]]],[]]
