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

غير قابل للتغيير. المعرّف الذي خصّصه 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)

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

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