REST Resource: courses.posts.addOnAttachments

المورد: AddOnAttach (المرفق)

مرفق إضافة في مشاركة

تمثيل 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

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

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][announcements.getAddOnContext] عندما يطّلِع أحد الطلاب على المرفق. في حال إسقاط معرّف الموارد المنتظم (URI) أو إزالته، سيتم أيضًا تجاهل maxPoints.

dueDate

object (Date)

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

dueTime

object (TimeOfDay)

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

maxPoints

number

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

copyHistory[]

object (CopyHistory)

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

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

الطُرق

create

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

delete

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

get

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

list

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

patch

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