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

مطلوب. عنوان هذا المرفق. يجب أن يتراوح العنوان بين حرف واحد و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) للمعلّم للاطّلاع على عمل الطالب في المرفق، إذا كان ذلك منطبقًا. سيتم فتح عنوان URL في إطار 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

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