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

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

معرّف الموارد المنتظم (URI) الذي ستتم إضافته إلى إطار iframe بعد ملؤه بمَعلمات طلب البحث.

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

string

مطلوب. معرّف الموارد المنتظم (URI) الذي ستتم إضافته إلى إطار iframe بعد ملؤه بمَعلمات طلب البحث. يجب أن تكون هذه السلسلة سلسلة UTF-8 صالحة تتضمّن عددًا يتراوح بين حرف واحد و1800 حرف.

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

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