Method: courses.announcements.modifyAssignees

Ändert den Zuweisungsmodus und die Optionen einer Mitteilung.

Nur eine Lehrkraft des Kurses, der die Mitteilung enthält, darf 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 Kursarbeit zuzugreifen, oder bei Zugriffsfehlern.
  • INVALID_ARGUMENT, wenn die Anfrage fehlerhaft ist.
  • NOT_FOUND, wenn der angeforderte Kurs oder die angeforderte Kursarbeit nicht vorhanden ist.
  • FAILED_PRECONDITION für den folgenden Anfragefehler:
    • EmptyAssignees

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 von Classroom zugewiesene Kennung oder eine alias sein.
id

string

Kennung der Ankündigung.

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 Schüler/Studenten oder nur 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 Autorisierungsleitfaden.