Verwenden Ihre Nutzer Classroom mit Google Meet? Weitere Informationen finden Sie unter Apps Script – Kurzanleitung.

Method: courses.announcements.modifyAssignees

Ändert den zugewiesenen Modus und die Optionen einer Ankündigung.

Diese Methode kann nur von einer Lehrkraft des Kurses aufgerufen werden, der die Ankündigung enthält.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht auf den angeforderten Kurs oder die Kursaufgabe zugreifen darf oder 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

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

id

string

Kennzeichnung 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 Mitteilung, aus dem hervorgeht, ob die Frage für alle oder nur für bestimmte Schüler oder Studenten zugänglich ist.

modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

Hier können Sie festlegen, welche Schüler/Studenten die Ankündigung ansehen oder nicht sehen dürfen. 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 in der OAuth 2.0-Übersicht.