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. ID des Kurses.

postId
(deprecated)

string

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

itemId

string

Nicht veränderbar. ID des Announcement, CourseWork oder CourseWorkMaterial, unter dem 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. Titel des 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 der Lehrkraft, um die Aufgaben von Schülern/Studenten im Anhang zu sehen (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. Dies muss angegeben werden, wenn dueTime angegeben ist.

dueTime

object (TimeOfDay)

Uhrzeit, zu der die Arbeit an diesem Anhang fällig ist (in UTC). Dies 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 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.