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

REST Resource: courses.announcements

Ressource: Ankündigung

Ankündigung einer Lehrkraft für Teilnehmer des Kurses

JSON-Darstellung
{
  "courseId": string,
  "id": string,
  "text": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (AnnouncementState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string
}
Felder
courseId

string

Kennung des Kurses.

Schreibgeschützt.

id

string

Die von Classroom zugewiesene Kennung dieser Ankündigung, die pro Kurs eindeutig ist.

Schreibgeschützt.

text

string

Beschreibung dieser Mitteilung Der Text muss ein gültiger UTF-8-String sein,der nicht mehr als 30.000 Zeichen enthält.

materials[]

object (Material)

Zusätzliche Materialien.

Ankündigungen dürfen nicht mehr als 20 Materialien enthalten.

state

enum (AnnouncementState)

Status dieser Mitteilung. Wenn nicht angegeben, ist der Standardstatus DRAFT.

creationTime

string (Timestamp format)

Zeitstempel für die Erstellung dieser Ankündigung

Schreibgeschützt.

Zeitstempel im Format RFC3339 UTC ZuZulu“ mit einer Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Zeitstempel der letzten Änderung dieser Mitteilung

Schreibgeschützt.

Zeitstempel im Format RFC3339 UTC ZuZulu“ mit einer Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

scheduledTime

string (Timestamp format)

Optionaler Zeitstempel für die Veröffentlichung der Ankündigung.

Zeitstempel im Format RFC3339 UTC ZuZulu“ mit einer Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

assigneeMode

enum (AssigneeMode)

Zuteilungsmodus der Mitteilung. Wenn nicht angegeben, ist der Standardwert ALL_STUDENTS.

individualStudentsOptions

object (IndividualStudentsOptions)

Kennungen der Kursteilnehmer, die Zugriff auf die Ankündigung haben Dieses Feld wird nur festgelegt, wenn assigneeMode den Wert INDIVIDUAL_STUDENTS hat. Wenn für assigneeMode der Wert INDIVIDUAL_STUDENTS festgelegt ist, können nur die in diesem Feld angegebenen Schüler/Studenten die Ankündigung sehen.

creatorUserId

string

Kennung des Nutzers, der die Ankündigung erstellt hat

Schreibgeschützt.

Ankündigungsstatus

Mögliche Status von Ankündigungen

Enums
ANNOUNCEMENT_STATE_UNSPECIFIED Kein Status angegeben. Dieser wird nie zurückgegeben.
PUBLISHED Status für eine bereits veröffentlichte Ankündigung. Dies ist der Standardstatus.
DRAFT Status für eine noch nicht veröffentlichte Ankündigung. Die Ankündigung in diesem Status ist nur für Lehrkräfte und Domainadministratoren sichtbar.
DELETED Status für eine Ankündigung, die veröffentlicht wurde, jetzt aber gelöscht ist. Die Ankündigung in diesem Status ist nur für Lehrkräfte und Domainadministratoren sichtbar. Die Ankündigung in diesem Status wird nach einiger Zeit gelöscht.

Methoden

create

Erstellt eine Ankündigung.

delete

Löscht eine Ankündigung.

get

Gibt eine Ankündigung zurück.

list

Gibt eine Liste von Ankündigungen zurück, die der Anforderer ansehen darf.

modifyAssignees

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

patch

Aktualisiert ein oder mehrere Felder einer Ankündigung.