Tài nguyên chủ đề đại diện cho một nhóm mục luồng được phân loại theo mức độ tương đồng, chẳng hạn như tuần đã giao hoặc chủ đề của khoá học.
Mỗi chủ đề được xác định bằng một mã nhận dạng duy nhất do máy chủ chỉ định. Mã này đi kèm với mã khoá học chứa chủ đề, tên chủ đề thực tế hiển thị trên giao diện người dùng Lớp học, cũng như ngày và giờ cập nhật gần đây nhất.
Tạo một chủ đề
Bạn có thể tạo chủ đề mới trong khoá học bằng phương thức topics.create()
như trong mẫu sau:
Java
Python
topic = {
"name": 'Example Topic'
}
response = service.courses().topics().create(
courseId=<course ID or alias>,
body=topic).execute()
print('Topic created: ', response['name'])
Truy xuất thông tin về chủ đề
Bạn có thể truy xuất các chủ đề của khoá học tương ứng bằng phương thức topics.get()
như trong mẫu sau:
Java
Python
response = service.courses().topics().get(
courseId=<course ID or alias>,
id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
Để biết danh sách khoá học, hãy sử dụng phương thức topics.list()
như minh hoạ trong
mẫu sau:
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']))
Cập nhật chủ đề
Bạn có thể cập nhật tên của chủ đề hiện có bằng phương thức topics.patch()
như trong mẫu sau:
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']))
Xoá chủ đề
Bạn có thể xoá một chủ đề hiện có bằng phương thức topics.delete()
như trong mẫu sau: