REST Resource: courses.courseWorkMaterials.addOnAttachments

Ressource: AddOnAttachment

Ein Add-on-Anhang an einen Beitrag.

JSON-Darstellung
{
  "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)
    }
  ]
}
Felder
courseId

string

Nicht veränderbar. Kennung des Kurses.

postId
(deprecated)

string

Nicht veränderbar. Verworfen, verwenden Sie stattdessen itemId.

itemId

string

Nicht veränderbar. Kennung der Announcement, CourseWork oder CourseWorkMaterial, unter der der Anhang angehängt ist. Eindeutig pro Kurs.

id

string

Nicht veränderbar. Von Classroom zugewiesene Kennung für diesen Anhang, die pro Beitrag eindeutig ist.

title

string

Erforderlich. Der Titel dieses Anhangs. Der Titel muss zwischen 1 und 1.000 Zeichen lang sein.

teacherViewUri

object (EmbedUri)

Erforderlich. URI, um die Ansicht des Anhangs für Lehrkräfte aufzurufen. Der URI wird in einem iFrame geöffnet, in dem die Abfrageparameter courseId, itemId, itemType und attachmentId festgelegt sind.

studentViewUri

object (EmbedUri)

Erforderlich. URI zum Anzeigen der Ansicht des Anhangs für Schüler/Studenten. Der URI wird in einem iFrame geöffnet, in dem die Abfrageparameter courseId, itemId, itemType und attachmentId festgelegt sind.

studentWorkReviewUri

object (EmbedUri)

URI, über den die Lehrkraft die Arbeit der Schüler/Studenten im Anhang sehen kann, falls zutreffend. Der URI wird in einem IFrame geöffnet, wobei die Abfrageparameter courseId, itemId, itemType, attachmentId und submissionId festgelegt sind. Dies ist dieselbe submissionId, die im Feld AddOnContext.studentContext zurückgegeben wird, wenn ein Schüler/Student sich den Anhang ansieht. Wird der URI weggelassen oder entfernt, wird auch maxPoints verworfen.

dueDate

object (Date)

Datum (UTC), an dem die Arbeit an diesem Anhang fällig ist. Muss angegeben werden, wenn dueTime angegeben ist.

dueTime

object (TimeOfDay)

Die Tageszeit in UTC, zu der die Arbeit an diesem Anhang fällig ist. Muss angegeben werden, wenn dueDate angegeben ist.

maxPoints

number

Höchstnote für diesen Anhang. Kann nur festgelegt werden, wenn studentWorkReviewUri festgelegt ist. Legen Sie einen Wert ungleich null fest, um anzugeben, dass der Anhang die Rückgabe von Noten unterstützt. Wenn festgelegt, muss dies eine nicht negative Ganzzahl sein. Wenn dieser Wert auf null gesetzt ist, wird das Zurücksenden von Noten für den Anhang nicht unterstützt.

copyHistory[]

object (CopyHistory)

Nur Ausgabe. IDs von Anhängen, die frühere Kopien dieses Anhangs waren.

Wenn der Anhang zuvor durch Kopieren des übergeordneten Beitrags kopiert wurde, werden die IDs der Anhänge, bei denen es sich um vorherige Kopien handelt, in aufsteigender chronologischer Reihenfolge der Kopie aufgelistet.

Methoden

create

Erstellt einen Add-on-Anhang unter einem Beitrag.

delete

Löscht einen Add-on-Anhang.

get

Gibt einen Add-on-Anhang zurück.

list

Gibt alle Anhänge zurück, die von einem Add-on unter dem Beitrag erstellt wurden

patch

Aktualisiert einen Add-on-Anhang.