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

string

غير قابل للتغيير. تمثّل هذه السمة معرّف الإشعار أو الدورة التدريبية أو الدورة التدريبية أو مواد الدورات التدريبية التي تمّ إرفاق المرفق بموجبها. فريدة لكل دورة تدريبية.

id

string

غير قابل للتغيير. المعرّف الذي خصّصه Classroom لهذا المرفق، وهو فريد لكل مشاركة.

title

string

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

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)

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

string

غير قابل للتغيير. تمثّل هذه السمة معرّف الإشعار أو الدورة التدريبية أو الدورة التدريبية أو مواد الدورات التدريبية التي تمّ إرفاق المرفق بموجبها.

attachmentId

string

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

الطُرق

create

ينشئ مرفق إضافة ضمن مشاركة.

delete

يؤدي هذا الإجراء إلى حذف مرفق إضافة.

get

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

list

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

patch

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