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

غير قابل للتغيير معرّف الإعلان أو الدورة التدريبية أو الدورة التدريبية Material الذي تم إرفاق المرفق تحته. فريد لكل دورة تدريبية.

id

string

غير قابل للتغيير المعرّف الذي ضبطه Classroom لهذا المرفق، فريد لكل مشاركة

title

string

مطلوبة. عنوان هذا المرفق. يجب أن يتراوح العنوان بين حرف واحد و1,000 حرف.

teacherViewUri

object (EmbedUri)

مطلوبة. معرّف الموارد المنتظم (URI) الذي يُظهر طريقة عرض المُعلِّم للمرفق. سيتم فتح معرّف الموارد المنتظم (URI) في إطار iframe مع ضبط مَعلمات طلب البحث courseId وpostId وattachmentId.

studentViewUri

object (EmbedUri)

مطلوبة. معرّف الموارد المنتظم (URI) الذي يُظهر طريقة عرض الطالب للمرفق. سيتم فتح معرّف الموارد المنتظم (URI) في إطار iframe مع ضبط مَعلمات طلب البحث courseId وpostId وattachmentId.

studentWorkReviewUri

object (EmbedUri)

معرّف الموارد المنتظم (URI) للمعلّم لمشاهدة أعمال الطالب على المرفق، إن وجد. سيتم فتح معرّف الموارد المنتظم (URI) في إطار iframe مع ضبط مَعلمات طلب البحث courseId وpostId وattachmentId وsubmissionId. وهذا هو submissionId نفسه الذي يعرضه [google.classroom.AddOns.GetAddOnContext][ann الإذنments.getAddOnContext] عندما يطّلِع أحد الطلاب على المرفق. في حال حذف معرّف الموارد المنتظم (URI) أو إزالته، سيتم أيضًا تجاهل maxPoints.

dueDate

object (Date)

تاريخ استحقاق التاريخ، بالتوقيت العالمي المنسّق، الذي يعمل على هذا المرفق. يجب تحديد هذه القيمة إذا تم تحديد dueTime.

dueTime

object (TimeOfDay)

الوقت من اليوم، بالتوقيت العالمي المنسّق (UTC)، مطلوب العمل على هذا المرفق. يجب تحديد هذه القيمة إذا تم تحديد dueDate.

maxPoints

number

الحد الأقصى للدرجة لهذا المرفق. لا يمكن ضبط السياسة إلّا في حال ضبط سياسة studentWorkReviewUri. يمكنك الضبط على قيمة غير صفرية للإشارة إلى أن المرفق يتيح التراجع عن الدرجة. في حال ضبط هذه السياسة، يجب أن تكون قيمة عدد صحيح غير سالبة. عند الضبط على صفر، لن يتيح المرفق التراجع عن الدرجة.

copyHistory[]

object (CopyHistory)

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

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

الطُرق

create

يتم إنشاء مرفق إضافة أسفل مشاركة.

delete

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

get

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

list

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

patch

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