یک پیوست افزودنی زیر یک پست ایجاد می کند.
به این افزونه نیاز دارد تا مجوز ایجاد پیوست های جدید در پست را داشته باشد.
این روش کدهای خطای زیر را برمی گرداند:
-
PERMISSION_DENIED
برای خطاهای دسترسی . - اگر درخواست نادرست باشد
INVALID_ARGUMENT
. - اگر یکی از منابع شناسایی شده وجود نداشته باشد،
NOT_FOUND
.
درخواست HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
courseId | ضروری. شناسه دوره |
itemId | شناسه اعلامیه، courseWork یا courseWorkMaterial که تحت آن پیوست ایجاد می شود. این فیلد الزامی است، اما زمانی که ما از postId مهاجرت می کنیم، به این صورت علامت گذاری نمی شود. |
پارامترهای پرس و جو
مولفه های | |
---|---|
postId | اختیاری. منسوخ شده است، به جای آن از itemId استفاده کنید. |
addOnToken | اختیاری. رمزی که درخواست را تأیید می کند. هنگامی که کاربر از Classroom به URL افزونه هدایت می شود، این رمز به عنوان یک پارامتر پرس و جو ارسال می شود. این نشانه مجوز برای ایجاد پیوست در کلاس درس لازم است اما برای ایجاد پیوست اول شریک اختیاری است. اگر برای ایجاد پیوست اول شریک ارائه نشده باشد و پروژههای برنامهنویسی که پیوست را ایجاد کردهاند و مورد جریان اصلی آن مطابقت نداشته باشند، خطایی را برمیگرداند. |
درخواست بدن
بدنه درخواست شامل یک نمونه از AddOnAttachment
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از AddOnAttachment
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/classroom.addons.teacher
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.