REST Resource: courses.posts.addOnAttachments

المرجع: AddOnComment

مرفق إضافة في مشاركة.

تمثيل 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)

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

object (Date)

التاريخ المحدّد بالتوقيت العالمي المنسّق (UTC) الذي يعمل على هذا المرفق مطلوب يجب تحديد ذلك إذا تم تحديد dueTime.
dueTime

object (TimeOfDay)

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

number

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

object (CopyHistory)

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

إذا تم نسخ المرفق في وقت سابق بموجب نسخ المشاركة الأصلية، يتم تعداد معرّفات المرفقات التي كانت نسخًا سابقة بترتيب تصاعدي (ترتيب زمني) للنسخة.

الطُرق

create

 ينشئ مرفق إضافة ضمن مشاركة.

delete

 يؤدي هذا الإجراء إلى حذف مرفق إضافة.

get

 عرض مرفق إضافة

list

 عرض جميع المرفقات التي تم إنشاؤها بواسطة إضافة ضمن المشاركة.

patch

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