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. Eingestellt. Verwenden Sie stattdessen „itemId“.

itemId

string

Nicht veränderbar. Kennung der Ankündigung, der CourseWork oder dercourseWorkMaterial-Ankündigung, 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. Titel des Anhangs. Der Titel muss zwischen 1 und 1.000 Zeichen lang sein.

teacherViewUri

object (EmbedUri)

Erforderlich. URI zum Anzeigen der Lehrkraftansicht des Anhangs. Der URI wird in einem iFrame geöffnet, in dem die Suchparameter courseId, postId 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 Suchparameter courseId, postId 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, in dem die Abfrageparameter courseId, postId, attachmentId und submissionId festgelegt sind. Dies ist dasselbe submissionId, das von [google.classroom.AddOns.GetAddOnContext][announcements.getAddOnContext] 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)

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). 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 Notenrücksendungen 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 in den iFrame geladen werden soll, nachdem Suchparameter aufgefüllt wurden.

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

string

Erforderlich. URI, der in den iFrame geladen werden soll, nachdem Suchparameter aufgefüllt wurden. Dies muss ein gültiger UTF-8-String mit 1 bis 1.800 Zeichen sein.

CopyHistory

ID einer früheren 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. Eingestellt. Verwenden Sie stattdessen „itemId“.

itemId

string

Nicht veränderbar. Kennung der Ankündigung, der CourseWork oder dercourseWorkMaterial-Ankündigung, unter der der Anhang angehängt ist.

attachmentId

string

Nicht veränderbar. ID 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.