افزونه های Google Classroom اکنون به طور کلی در دسترس توسعه دهندگان هستند! لطفاً برای اطلاعات بیشتر به
اسناد افزونه ها مراجعه کنید.
ارسال بازخورد
Method: userProfiles.guardianInvitations.list
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
فهرستی از دعوتنامههای نگهبان را که کاربر درخواستکننده مجاز به مشاهده آنها است، با پارامترهای ارائهشده فیلتر میکند.
این روش کدهای خطای زیر را برمی گرداند:
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
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر پارامترها 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-09-18 بهوقت ساعت هماهنگ جهانی.
[{
"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\u06cc\u062e \u0622\u062e\u0631\u06cc\u0646 \u0628\u0647\u200c\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06cc 2024-09-18 \u0628\u0647\u200c\u0648\u0642\u062a \u0633\u0627\u0639\u062a \u0647\u0645\u0627\u0647\u0646\u06af \u062c\u0647\u0627\u0646\u06cc."}
[[["درک آسان","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-18 بهوقت ساعت هماهنگ جهانی."]]