REST Resource: courses.posts.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)
    }
  ],
  "gradeSyncEnabled": boolean
}
الحقول
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)

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

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

boolean

النتائج فقط. تحدّد هذه السمة ما إذا كان سيتم نسخ التغييرات التي تم إجراؤها على قيم pointsEarned في student submissions لهذا المرفق إلى حقل pointsEarned في CourseWork submissions للطلاب. يمكن أن يكون هذا الحقل true لمرفق إضافة واحد كحد أقصى لكل عنصر في ساحة المشاركات.

الطُرق

create

 تنشئ هذه الطريقة مرفقًا لإضافة ضمن منشور.

delete

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

get

 لعرض مرفق إضافة

list

 تعرض هذه الطريقة جميع المرفقات التي أنشأتها إضافة ضمن المنشور.

patch

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