Method: courses.announcements.modifyAssignees

Ändert den Modus für die Zuweisung und die Optionen einer Ansage.

Nur ein Kursleiter des Kurses, der die Ankündigung enthält, kann diese Methode aufrufen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, auf die angeforderte Kurs- oder Kursaufgabe zuzugreifen, oder wenn Zugriffsfehler vorliegen.
  • 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. Diese Kennung 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, der beschreibt, ob sie für alle oder nur bestimmte Schüler/Studenten zugänglich ist.

modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

Legen Sie fest, welche Schüler/Studenten die Ankündigung sehen können und welche 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.