Konu kaynağı, atanan hafta veya kurs konusu gibi benzerliğe göre kategorize edilmiş akış öğeleri grubunu temsil eder.
Her konu, sunucu tarafından atanan benzersiz bir kimlikle tanımlanır. Bu kimlikle ilişkilendirilen konu; konunun ait olduğu ders kimliği, Classroom kullanıcı arayüzünde gösterilen gerçek konu adı ve son güncellemenin tarihi ve saatidir.
Konu oluşturma
Aşağıdaki örnekte gösterildiği gibi, topics.create()
yöntemini kullanarak bir derste yeni bir konu oluşturabilirsiniz:
Java
Python
topic = {
"name": 'Example Topic'
}
response = service.courses().topics().create(
courseId=<course ID or alias>,
body=topic).execute()
print('Topic created: ', response['name'])
Konu ayrıntılarını alma
Aşağıdaki örnekte gösterildiği gibi, topics.get()
yöntemiyle karşılık gelen bir kursun konularını alabilirsiniz:
Java
Python
response = service.courses().topics().get(
courseId=<course ID or alias>,
id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
Kurs listesi için aşağıdaki örnekte gösterildiği gibi topics.list()
yöntemini kullanın:
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']))
Konuları güncelle
Mevcut bir konunun adını, aşağıdaki örnekte gösterildiği gibi topics.patch()
yöntemiyle güncelleyebilirsiniz:
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']))
Konuları silin
Mevcut bir konuyu, aşağıdaki örnekte gösterildiği gibi topics.delete()
yöntemiyle silebilirsiniz: