Method: courses.announcements.modifyAssignees

Ändert den Modus für die zuständige Person und die Optionen einer Ankündigung.

Nur eine Lehrkraft des Kurses, die 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 den angeforderten Kurs oder die angeforderten Kursarbeiten zuzugreifen, oder wenn Zugriffsfehler aufgetreten sind.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn die angeforderte Kurs- oder 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 ID 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 Mitteilung, die beschreibt, ob alle oder nur bestimmte Schüler/Studenten darauf zugreifen können.
modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

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