Um recurso de tema representa um grupo de itens de fluxo categorizados por similaridade, como a semana atribuída ou o assunto do curso.
Cada tópico é identificado por um ID exclusivo atribuído pelo servidor. Associados a esse ID estão o ID do curso a que o tema pertence, o nome real do tema mostrado na interface do Google Sala de Aula e a data e a hora da última atualização.
Criar um tópico
Para criar um novo tópico em um curso, use o método
topics.create()
, conforme mostrado no exemplo a seguir:
Java
Python
topic = {
"name": 'Example Topic'
}
response = service.courses().topics().create(
courseId=<course ID or alias>,
body=topic).execute()
print('Topic created: ', response['name'])
Recuperar detalhes do tópico
Recupere temas de um curso correspondente com o método
topics.get()
, conforme mostrado no exemplo a seguir:
Java
Python
response = service.courses().topics().get(
courseId=<course ID or alias>,
id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
Para ver uma lista de cursos, use o método topics.list()
, conforme mostrado no
exemplo a seguir:
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']))
Atualizar tópicos
É possível atualizar o nome de um tópico existente com o método topics.patch()
, conforme mostrado no exemplo a seguir:
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']))
Excluir tópicos
Exclua um tópico atual com o método topics.delete()
, conforme mostrado
neste exemplo: