Resource topik mewakili sekelompok item streaming yang dikategorikan berdasarkan kemiripan, seperti minggu yang ditetapkan atau subjek kursus.
Setiap topik diidentifikasi oleh ID unik yang ditetapkan oleh server. Terkait dengan ID ini adalah ID kursus yang dimiliki topik, nama topik sebenarnya yang ditampilkan di UI Classroom, serta tanggal dan waktu pembaruan terakhir.
Membuat topik
Anda dapat membuat topik baru dalam kursus menggunakan
metode topics.create()
, seperti ditunjukkan pada contoh berikut:
Java
Python
topic = {
"name": 'Example Topic'
}
response = service.courses().topics().create(
courseId=<course ID or alias>,
body=topic).execute()
print('Topic created: ', response['name'])
Mengambil detail topik
Anda dapat mengambil topik kursus terkait dengan metode topics.get()
, seperti yang ditunjukkan pada contoh berikut:
Java
Python
response = service.courses().topics().get(
courseId=<course ID or alias>,
id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
Untuk melihat daftar kursus, gunakan metode topics.list()
, seperti ditunjukkan pada
contoh berikut:
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']))
Perbarui beberapa topik
Anda dapat memperbarui nama topik yang sudah ada dengan metode
topics.patch()
, seperti ditunjukkan dalam contoh berikut:
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']))
Hapus topik
Anda dapat menghapus topik yang ada dengan metode topics.delete()
, seperti ditunjukkan
pada contoh berikut: