Method: courses.courseWorkMaterials.addOnAttachments.create

یک پیوست افزودنی زیر یک پست ایجاد می کند.

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

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

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

درخواست HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments

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

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

پارامترها
courseId

string

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

itemId

string

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

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

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

string

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

addOnToken

string

اختیاری. رمزی که درخواست را تأیید می کند.

هنگامی که کاربر از Classroom به URL افزونه هدایت می شود، این رمز به عنوان یک پارامتر پرس و جو ارسال می شود.

این نشانه مجوز برای ایجاد پیوست در کلاس درس لازم است اما برای ایجاد پیوست اول شریک اختیاری است. اگر برای ایجاد پیوست اول شریک ارائه نشده باشد و پروژه‌های برنامه‌نویسی که پیوست را ایجاد کرده‌اند و مورد جریان اصلی آن مطابقت نداشته باشند، خطایی را برمی‌گرداند.

درخواست بدن

بدنه درخواست شامل یک نمونه از AddOnAttachment است.

بدن پاسخگو

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

محدوده مجوز

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

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

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