REST Resource: courses.announcements.addOnAttachments

منبع: AddOnAttachment

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

نمایندگی JSON 
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "id": string,
  "title": string,
  "teacherViewUri": {
    object (EmbedUri)
  },
  "studentViewUri": {
    object (EmbedUri)
  },
  "studentWorkReviewUri": {
    object (EmbedUri)
  },
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "maxPoints": number,
  "copyHistory": [
    {
      object (CopyHistory)
    }
  ]
}
فیلدها
courseId

string

تغییرناپذیر. شناسه دوره

postId
(deprecated)

string

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

itemId

string

تغییرناپذیر. شناسه Announcement ، CourseWork ، یا CourseWorkMaterial که پیوست تحت آن پیوست شده است. منحصر به فرد در هر دوره

id

string

تغییرناپذیر. شناسه اختصاص داده شده به کلاس برای این پیوست، منحصر به فرد در هر پست.

title

string

مورد نیاز. عنوان این پیوست عنوان باید بین 1 تا 1000 کاراکتر باشد.

teacherViewUri

object ( EmbedUri )

مورد نیاز. URI برای نشان دادن نمای معلم از پیوست. URI در یک iframe با مجموعه پارامترهای query courseId ، itemId ، itemType و attachmentId باز می شود.

studentViewUri

object ( EmbedUri )

مورد نیاز. URI برای نشان دادن نمای دانشجو از پیوست. URI در یک iframe با مجموعه پارامترهای query courseId ، itemId ، itemType و attachmentId باز می شود.

studentWorkReviewUri

object ( EmbedUri )

URI برای معلم برای دیدن کار دانش‌آموز روی پیوست، در صورت وجود. URI در یک iframe با مجموعه پارامترهای query courseId ، itemId ، itemType ، attachmentId و submissionId باز می شود. این همان submissionId است که در فیلد AddOnContext.studentContext هنگام مشاهده پیوست توسط دانش آموز بازگردانده می شود. اگر URI حذف یا حذف شود، maxPoints نیز کنار گذاشته خواهد شد.

dueDate

object ( Date )

تاریخ، در UTC، موعد کار روی این پیوست است. اگر dueTime مشخص شده باشد باید مشخص شود.

dueTime

object ( TimeOfDay )

زمان از روز، در UTC، کار بر روی این پیوست موعد است. در صورتی که dueDate مشخص شده باشد، این باید مشخص شود.

maxPoints

number

حداکثر نمره برای این پیوست. فقط در صورتی تنظیم می شود که studentWorkReviewUri تنظیم شده باشد. مقدار غیر صفر را تنظیم کنید تا نشان دهد که پیوست از برگشت نمره پشتیبانی می کند. اگر تنظیم شود، این باید یک مقدار صحیح غیر منفی باشد. وقتی روی صفر تنظیم می‌شود، پیوست از پس‌رفت نمره پشتیبانی نمی‌کند.

copyHistory[]

object ( CopyHistory )

فقط خروجی شناسه‌های پیوست‌هایی که نسخه‌های قبلی این پیوست بودند.

اگر پیوست قبلاً به دلیل کپی شدن پست والد آن کپی شده بود، این شناسه پیوست‌هایی را که کپی‌های قبلی آن بودند به ترتیب زمانی صعودی کپی برمی‌شمارد.

EmbedUri

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

نمایندگی JSON 
{
  "uri": string
}
فیلدها
uri

string

مورد نیاز. URI پس از پر شدن با پارامترهای پرس و جو، iframe شود. این باید یک رشته معتبر UTF-8 حاوی 1 تا 1800 کاراکتر باشد.

CopyHistory

شناسه یک کپی قبلی از یک پیوست داده شده.

نمایندگی JSON 
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "attachmentId": string
}
فیلدها
courseId

string

تغییرناپذیر. شناسه دوره

postId
(deprecated)

string

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

itemId

string

تغییرناپذیر. شناسه Announcement ، CourseWork ، یا CourseWorkMaterial که پیوست تحت آن پیوست شده است.

attachmentId

string

تغییرناپذیر. شناسه پیوست

روش ها

create

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

delete

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

get

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

list

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

patch

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