افزونه های Google Classroom اکنون به طور کلی در دسترس توسعه دهندگان هستند! لطفاً برای اطلاعات بیشتر به
اسناد افزونه ها مراجعه کنید.
ارسال بازخورد
Method: courses.announcements.list
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
فهرستی از اعلانهایی را برمیگرداند که درخواستکننده مجاز به مشاهده آنها هستند.
دانشجویان دوره فقط می توانند اطلاعیه های PUBLISHED
را مشاهده کنند. معلمان دوره و مدیران دامنه می توانند همه اعلامیه ها را مشاهده کنند.
این روش کدهای خطای زیر را برمی گرداند:
اگر کاربر درخواست کننده اجازه دسترسی به دوره درخواستی یا خطاهای دسترسی را نداشته باشد، PERMISSION_DENIED
. اگر درخواست نادرست باشد INVALID_ARGUMENT
. اگر دوره درخواستی وجود نداشته باشد، NOT_FOUND
. درخواست HTTP GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر پارامترها courseId
string
شناسه دوره این شناسه می تواند شناسه اختصاص داده شده توسط Classroom یا alias
باشد.
پارامترهای پرس و جو پارامترها announcementStates[]
enum ( AnnouncementState
)
محدودیت در state
اطلاعیه ها بازگشت. اگر این آرگومان نامشخص رها شود، مقدار پیشفرض PUBLISHED
است.
orderBy
string
مرتب سازی اختیاری برای نتایج. فهرستی از فیلدهای جدا شده با کاما با کلمه کلیدی جهت مرتب سازی اختیاری. فیلد پشتیبانی شده updateTime
است. کلمات کلیدی جهت پشتیبانی شده asc
و desc
هستند. اگر مشخص نشده باشد، updateTime desc
رفتار پیشفرض است. مثالها: updateTime asc
، updateTime
pageSize
integer
حداکثر تعداد اقلام برای بازگشت. صفر یا نامشخص نشان می دهد که سرور ممکن است حداکثر را اختصاص دهد.
سرور ممکن است کمتر از تعداد مشخص شده نتایج را برگرداند.
pageToken
string
مقدار nextPageToken
برگردانده شده از فراخوانی list
قبلی، نشان می دهد که صفحه بعدی نتایج باید برگردانده شود.
در غیر این صورت، درخواست list
باید با درخواستی که منجر به این نشانه شده است، یکسان باشد.
درخواست بدن بدنه درخواست باید خالی باشد.
بدن پاسخگو پاسخ هنگام فهرست کردن کار دوره.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON {
"announcements" : [
{
object (Announcement
)
}
] ,
"nextPageToken" : string
}
فیلدها announcements[]
object ( Announcement
)
موارد اعلامیه مطابق با درخواست
nextPageToken
string
نشانه شناسایی صفحه بعدی نتایج برای بازگشت. اگر خالی باشد، هیچ نتیجه دیگری در دسترس نیست.
محدوده مجوز به یکی از حوزه های OAuth زیر نیاز دارد:
https://www.googleapis.com/auth/classroom.announcements
https://www.googleapis.com/auth/classroom.announcements.readonly
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
ارسال بازخورد
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-09-05 بهوقت ساعت هماهنگ جهانی.
[{
"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-05 \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-05 بهوقت ساعت هماهنگ جهانی."]]