Method: courses.announcements.addOnAttachments.list

همه پیوست‌های ایجاد شده توسط یک افزونه در زیر پست را برمی‌گرداند.

این افزونه به داشتن پیوست‌های فعال در پست یا داشتن مجوز ایجاد پیوست‌های جدید در پست نیاز دارد.

این روش کدهای خطای زیر را برمی گرداند:

  • PERMISSION_DENIED برای خطاهای دسترسی .
  • اگر درخواست نادرست باشد INVALID_ARGUMENT .
  • اگر یکی از منابع شناسایی شده وجود نداشته باشد، NOT_FOUND .

درخواست HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
course Id

string

مورد نیاز. شناسه دوره

item Id

string

شناسه Announcement ، CourseWork ، یا CourseWorkMaterial که پیوست‌های آن باید برشمرده شوند. این فیلد الزامی است، اما زمانی که ما از postId مهاجرت می کنیم، به این صورت علامت گذاری نمی شود.

پارامترهای پرس و جو

پارامترها
postId
(deprecated)

string

اختیاری. شناسه پست تحت دوره ای که پیوست های آن را شمارش کنید. منسوخ شده است، به جای آن از itemId استفاده کنید.

page Size

integer

حداکثر تعداد پیوست برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند. اگر نامشخص باشد، حداکثر 20 پیوست بازگردانده می شود. حداکثر مقدار 20 است. مقادیر بالای 20 به 20 اجباری می شود.

page Token

string

یک نشانه صفحه، دریافت شده از تماس قبلی addOnAttachments.list . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به addOnAttachments.list باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از ListAddOnAttachmentsResponse است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/classroom.addons.student
  • https://www.googleapis.com/auth/classroom.addons.teacher

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.