REST Resource: courses.announcements.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, 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 sich ein Schüler oder Student den Anhang ansieht. Wird der URI weggelassen oder entfernt, wird auch maxPoints verworfen.

dueDate

object (Date)

Das Datum in UTC für die Bearbeitung dieses Anhangs ist fällig. Dies muss angegeben werden, wenn dueTime angegeben ist.

dueTime

object (TimeOfDay)

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

EmbedUri

URI, der nach dem Ausfüllen mit Abfrageparametern in einen Frame eingebettet wird.

JSON-Darstellung
{
  "uri": string
}
Felder
uri

string

Erforderlich. URI, der nach dem Ausfüllen mit Abfrageparametern in einen Frame eingebettet wird. Dies muss ein gültiger UTF-8-String mit 1 bis 1.800 Zeichen sein.

CopyHistory

Kennung einer vorherigen Kopie eines bestimmten Anhangs.

JSON-Darstellung
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "attachmentId": string
}
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.

attachmentId

string

Nicht veränderbar. Kennung des Anhangs.

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.