REST Resource: courses.posts.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 و1,000 حرف.
teacherViewUri

object (EmbedUri)

مطلوب. معرّف موارد منتظم (URI) لعرض طريقة عرض المعلّم للمرفق سيتم فتح معرّف URI في إطار iframe مع ضبط مَعلمات طلب البحث courseId وitemId وitemType وattachmentId.
studentViewUri

object (EmbedUri)

مطلوب. معرّف الموارد المنتظم (URI) لعرض طريقة عرض الطالب للمرفق سيتم فتح معرّف URI في إطار iframe مع ضبط مَعلمات طلب البحث courseId وitemId وitemType وattachmentId.
studentWorkReviewUri

object (EmbedUri)

عنوان URL للمعلّم للاطّلاع على عمل الطالب في المرفق، إذا كان ذلك منطبقًا سيتم فتح معرّف الموارد المنتظم (URI) في إطار iframe مع ضبط مَعلمات طلب البحث courseId وitemId وitemType وattachmentId وsubmissionId. وهذا هو submissionId نفسه الذي يتم إرجاعه في حقل AddOnContext.studentContext عندما يطّلع أحد الطلاب على المرفق. في حال حذف أو حذف معرّف الموارد المنتظم (URI)، سيتم أيضًا تجاهل maxPoints.
dueDate

object (Date)

التاريخ بالتوقيت العالمي المنسق الذي يجب تسليم العمل على هذا المرفق فيه يجب تحديد هذا الخيار إذا تم تحديد dueTime.
dueTime

object (TimeOfDay)

وقت العمل على هذا المرفق بالتوقيت العالمي المنسّق يجب تحديد هذا الخيار إذا تم تحديد dueDate.
maxPoints

number

الحد الأقصى للدرجة لهذا المرفق. لا يمكن ضبطه إلا إذا تم ضبط studentWorkReviewUri. اضبطها على قيمة غير صفرية للإشارة إلى أنّ المرفق يتيح إعادة إرسال الدرجات. في حال ضبطه، يجب أن تكون هذه القيمة عددًا صحيحًا غير سالب. عند ضبط القيمة على صفر، لن يتيح المرفق إعادة إرسال الدرجات.
copyHistory[]

object (CopyHistory)

النتائج فقط. معرّفات المرفقات التي كانت نُسخًا سابقة من هذا المرفق

إذا سبق نسخ المرفق بسبب نسخ المشاركة الرئيسية، يتم إدراج معرّفات المرفقات التي كانت نُسخه السابقة بترتيب زمني تصاعدي.

الطُرق

create

 لإنشاء مرفق إضافة ضمن مشاركة.

delete

 لحذف مرفق إضافة

get

 تعرِض هذه السمة مرفق إضافة.

list

 عرض جميع المرفقات التي أنشأتها إحدى الإضافات ضمن المشاركة

patch

 تعديل مرفق إضافة