Method: courses.announcements.modifyAssignees

Ändert den Modus der zuständigen Person und Optionen für eine Ankündigung.

Nur Lehrkräfte des Kurses, die die Mitteilung enthalten, können diese Methode aufrufen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht auf die angeforderte Kurs- oder Kursaufgabe oder für Zugriffsfehler zugreifen darf.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs oder die angeforderte Kursaufgabe nicht vorhanden ist.

HTTP-Anfrage

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{id}:modifyAssignees

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

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

id

string

ID der Mitteilung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "assigneeMode": enum (AssigneeMode),
  "modifyIndividualStudentsOptions": {
    object (ModifyIndividualStudentsOptions)
  }
}
Felder
assigneeMode

enum (AssigneeMode)

Modus der Ankündigung, in dem beschrieben wird, ob alle oder nur bestimmte Schüler oder Studenten darauf zugreifen können

modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

Legen Sie fest, welche Schüler und Studenten sich die Ankündigung ansehen können oder nicht. Muss nur angegeben werden, wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/classroom.announcements

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.