Method: courses.announcements.modifyAssignees

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

Nur eine Lehrkraft des Kurses, in dem die Ankündigung enthalten ist, kann diese Methode aufrufen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht auf den angeforderten Kurs oder die angeforderten Kursmaterialien zugreifen darf, oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs oder die angeforderte Kursarbeit 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

Kennung des Kurses. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine alias sein.
id

string

Kennung der Mitteilung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

enum (AssigneeMode)

Der Modus der Ankündigung, der angibt, ob sie für alle Schüler/Studenten oder für bestimmte Schüler/Studenten zugänglich ist.
modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

Legen Sie fest, welche Schüler/Studenten die Mitteilung sehen können und welche nicht. Muss nur angegeben werden, wenn assigneeMode INDIVIDUAL_STUDENTS ist.

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.