REST Resource: courses.courseWorkMaterials.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

غير قابل للتغيير المعرّف الذي خصّصه Classroom لهذا المرفق، وهو فريد لكل مشاركة.

title

string

مطلوب. عنوان هذا المرفق. يجب أن يتراوح العنوان بين حرف واحد و1000 حرف.

teacherViewUri

object (EmbedUri)

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

studentViewUri

object (EmbedUri)

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

studentWorkReviewUri

object (EmbedUri)

تمثّل هذه السمة معرّف موارد منتظم (URI) للمعلّم للاطّلاع على عمل الطالب في المرفق، إذا كان ذلك منطبقًا. سيتم فتح معرِّف الموارد المنتظم (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

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