REST Resource: courses.courseWorkMaterials.addOnAttachments

Ressource: AddOnAttachment

Ein Add-on-Anhang zu einem 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, eindeutig pro Beitrag.

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, um die Ansicht des Anhangs für Schüler/Studenten anzuzeigen. 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 oder Student den Anhang aufruft. Wenn der URI weggelassen oder entfernt wird, 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

Die höchste Note 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 der Wert auf null gesetzt ist, unterstützt der Anhang keinen Noten-Passback.

copyHistory[]

object (CopyHistory)

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

Wenn der Anhang zuvor kopiert wurde, weil der übergeordnete Beitrag kopiert wurde, werden hier die IDs der Anhänge aufgelistet, die die vorherigen Kopien waren, in aufsteigender chronologischer Reihenfolge der Kopie.

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.