Method: courses.courseWork.studentSubmissions.modifyAttachments

Damit werden Anhänge zu abgegebenen Aufgaben von Schülern/Studenten geändert.

Anhänge können nur abgegebenen Aufgaben von Schülern/Studenten hinzugefügt werden, die zu Kursobjekten mit einer workType von ASSIGNMENT gehören.

Diese Anfrage muss über das Developer Console-Projekt der OAuth-Client-ID gestellt werden, die zur Erstellung des entsprechenden Arbeitselements des Kurses verwendet wurde.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, auf den angeforderten Kurs oder die angeforderte Kursaufgabe zuzugreifen, er darf keine Anhänge der angeforderten Aufgabe ändern oder Zugriffsfehler bestehen.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs, die angeforderte Kursaufgabe oder die Aufgabe des Schülers/Studenten nicht vorhanden ist.

HTTP-Anfrage

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

ID des Kurses. Diese Kennung kann entweder die von Classroom zugewiesene ID oder eine alias sein.
courseWorkId

string

ID der Kursaufgabe.
id

string

ID der abgegebenen Aufgabe des Schülers/Studenten.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "addAttachments": [
    {
      object (Attachment)
    }
  ],
  "previewVersion": enum (PreviewVersion)
}
Felder
addAttachments[]

object (Attachment)

Anhänge, die hinzugefügt werden sollen. Eine abgegebene Aufgabe darf nicht mehr als 20 Anhänge haben.

Form Anhänge werden nicht unterstützt.
previewVersion

enum (PreviewVersion)

Optional. Die Vorschauversion der API. Diese Einstellung muss aktiviert sein, damit Sie auf neue API-Funktionen zugreifen können, die Entwicklern im Vorschauprogramm zur Verfügung gestellt werden.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von StudentSubmission.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.