משאב נושא מייצג קבוצה של פריטים בשידור שמסווגים לפי מידת דמיון, כמו השבוע שהוקצה או נושא הקורס.
כל נושא מזוהה באמצעות מזהה ייחודי שהוקצה על ידי השרת. המזהה הזה משויך למזהה הקורס שאליו שייך הנושא, לשם הנושא שמוצג בפועל בממשק המשתמש של Classroom והתאריך והשעה של העדכון האחרון.
יצירת נושא
אפשר ליצור נושא חדש בקורס באמצעות השיטה topics.create()
, כמו בדוגמה הבאה:
Java
Python
topic = {
"name": 'Example Topic'
}
response = service.courses().topics().create(
courseId=<course ID or alias>,
body=topic).execute()
print('Topic created: ', response['name'])
אחזר פרטי נושא
אפשר לאחזר נושאים של קורס תואם באמצעות השיטה topics.get()
, כמו בדוגמה הבאה:
Java
Python
response = service.courses().topics().get(
courseId=<course ID or alias>,
id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
לרשימת הקורסים, כדאי להשתמש בשיטה topics.list()
, כפי שמוצג בדוגמה הבאה:
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']))
עדכון הנושאים
אפשר לעדכן שם של נושא קיים באמצעות method topics.patch()
, כמו בדוגמה הבאה:
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']))
מחיקת נושאים
אפשר למחוק נושא קיים באמצעות השיטה topics.delete()
, כמו בדוגמה הבאה: