Eine Themenressource stellt eine Gruppe von Streamelementen dar, die nach Ähnlichkeit kategorisiert sind, z. B. die zugewiesene Woche oder das Kursthema.
Jedes Thema ist durch eine eindeutige ID gekennzeichnet, die vom Server zugewiesen wird. Dieser ID sind die Kurs-ID, zu der das Thema gehört, der tatsächliche Themenname, der in der Classroom-Benutzeroberfläche angezeigt wird, sowie Datum und Uhrzeit der letzten Aktualisierung zugeordnet.
Thema erstellen
Mit der Methode topics.create()
können Sie ein neues Thema in einem Kurs erstellen, wie im folgenden Beispiel gezeigt:
Java
Python
topic = {
"name": 'Example Topic'
}
response = service.courses().topics().create(
courseId=<course ID or alias>,
body=topic).execute()
print('Topic created: ', response['name'])
Themendetails abrufen
Mit der Methode topics.get()
können Sie Themen eines entsprechenden Kurses abrufen, wie im folgenden Beispiel gezeigt:
Java
Python
response = service.courses().topics().get(
courseId=<course ID or alias>,
id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
Für eine Liste von Kursen verwenden Sie die Methode topics.list()
, wie im folgenden Beispiel gezeigt:
Java
Python
topics = []
page_token = None
while True:
response = service.courses().topics().list(
pageToken=page_token,
pageSize=30,
courseId=<course ID or alias>).execute()
topics.extend(response.get('topic', []))
page_token = response.get('nextPageToken', None)
if not page_token:
break
if not topics:
print('No topics found.')
else:
print('Topics:')
for topic in topics:
print('{0} ({1})'.format(topic['name'], topic['topicId']))
Themen aktualisieren
Sie können den Namen eines vorhandenen Themas mit der Methode topics.patch()
aktualisieren, wie im folgenden Beispiel gezeigt:
Java
Python
topic = {
"name": "New Topic Name"
}
response = service.courses().topics().patch(
courseId=<course ID or alias>,
id=<topic ID>,
updateMask="name",
body=topic).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
Themen löschen
Mit der Methode topics.delete()
können Sie ein vorhandenes Thema löschen, wie im folgenden Beispiel gezeigt: