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

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

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

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

EmbedUri

عنوان URL الذي سيتم تضمينه في إطار iframe بعد تعبئته بمَعلمات طلب البحث

تمثيل JSON 
{
  "uri": string
}
الحقول
uri

string

مطلوب. عنوان URL الذي سيتم تضمينه في إطار iframe بعد تعبئته بمَعلمات طلب البحث يجب أن تكون هذه القيمة سلسلة UTF-8 صالحة تحتوي على ما بين حرف واحد و1,800 حرف.

CopyHistory

معرّف نسخة سابقة من مرفق معيّن

تمثيل JSON 
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "attachmentId": string
}
الحقول
courseId

string

غير قابل للتغيير معرّف الدورة التدريبية.
postId
(deprecated)

string

غير قابل للتغيير تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام itemId بدلاً منها.
itemId

string

غير قابل للتغيير معرّف Announcement أو CourseWork أو CourseWorkMaterial الذي تم إرفاق المرفق به
attachmentId

string

غير قابل للتغيير معرّف المرفق

الطُرق

create

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

delete

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

get

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

list

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

patch

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