จัดการหัวข้อ

Topic คือป้ายกำกับสำหรับการจัดกลุ่มรายการสตรีม CourseWork และ CourseWorkMaterial ภายในหลักสูตร โดยปกติแล้ว Topic จะใช้เพื่อจัดหมวดหมู่รายการเหล่านี้ตามความคล้ายคลึงกัน เช่น สัปดาห์ที่ได้รับมอบหมายรายการ หรือหัวข้อของรายการ ผู้ใช้สามารถจัดระเบียบและกรองรายการสตรีมในมุมมองงานของชั้นเรียนของ UI ของ Classroom ได้

Topic แต่ละรายการจะระบุด้วยรหัสที่ไม่ซ้ำกันที่เซิร์ฟเวอร์กำหนด แหล่งข้อมูล Topic ยังมีข้อมูลต่อไปนี้ด้วย

• name: ชื่อที่แสดงใน UI ของ Classroom
• updateTime: เวลาที่มีการอัปเดต Topic ครั้งล่าสุด
• courseId: รหัสของหลักสูตรที่ Topic เชื่อมโยงอยู่

สร้างหัวข้อ

คุณสามารถสร้าง Topic ใหม่ในหลักสูตรได้โดยใช้เมธอด topics.create() ดังที่แสดงในตัวอย่างนี้

Java

classroom/snippets/src/main/java/CreateTopic.java

ดูใน GitHub

Topic topic = null;
try {
  // Create the new Topic.
  Topic content = new Topic().setName("Semester 1");
  topic = service.courses().topics().create(courseId, content).execute();
  System.out.println("Topic id: " + topic.getTopicId() + "\n" + "Course id: " + courseId);
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The courseId does not exist: %s.\n", courseId);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return topic;

Python

topic = {
    "name": 'Example Topic'
}
response = service.courses().topics().create(
  courseId=<course ID or alias>,
  body=topic).execute()
print('Topic created: ', response['name'])

ฟิลด์ name เป็นฟิลด์ที่ต้องกรอกเสมอและต้องเป็นสตริงที่ไม่ใช่สตริงว่าง ช่องอื่นๆ ทั้งหมดเป็นช่องที่ไม่บังคับ

สำคัญ: มีข้อบกพร่องที่ทำให้ Topic ที่สร้างขึ้นโดยมีเว้นวรรคอยู่ท้ายไฟล์ใช้งานใน Classroom ไม่ได้ อย่าลืมนำเว้นวรรคต่อท้ายออกเมื่อสร้าง Topic

เรียกข้อมูลรายละเอียดหัวข้อ

คุณสามารถดึงข้อมูล Topic ที่เฉพาะเจาะจงตามรหัสด้วยเมธอด topics.get() ดังที่แสดงในตัวอย่างต่อไปนี้

Java

classroom/snippets/src/main/java/GetTopic.java

ดูใน GitHub

Topic topic = null;
try {
  // Get the topic.
  topic = service.courses().topics().get(courseId, topicId).execute();
  System.out.printf("Topic '%s' found.\n", topic.getName());
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The courseId or topicId does not exist: %s, %s.\n", courseId, topicId);
  }
  throw e;
} catch (Exception e) {
  throw e;
}
return topic;

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() เพื่อดึงข้อมูล Topic ทั้งหมดในหลักสูตร ดังที่แสดงในตัวอย่างต่อไปนี้

Java

classroom/snippets/src/main/java/ListTopics.java

ดูใน GitHub

List<Topic> topics = new ArrayList<>();
String pageToken = null;

try {
  do {
    ListTopicResponse response =
        service
            .courses()
            .topics()
            .list(courseId)
            .setPageSize(100)
            .setPageToken(pageToken)
            .execute();

    /* Ensure that the response is not null before retrieving data from it to avoid errors. */
    if (response.getTopic() != null) {
      topics.addAll(response.getTopic());
      pageToken = response.getNextPageToken();
    }
  } while (pageToken != null);

  if (topics.isEmpty()) {
    System.out.println("No topics found.");
  } else {
    for (Topic topic : topics) {
      System.out.printf("%s (%s)\n", topic.getName(), topic.getTopicId());
    }
  }
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The courseId does not exist: %s.\n", courseId);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return topics;

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']))

อัปเดตหัวข้อ

คุณสามารถอัปเดต Topic name ที่มีอยู่ด้วยเมธอด topics.patch() ดังที่แสดงในตัวอย่างต่อไปนี้

Java

classroom/snippets/src/main/java/UpdateTopic.java

ดูใน GitHub

Topic topic = null;
try {
  // Retrieve the topic to update.
  Topic topicToUpdate = service.courses().topics().get(courseId, topicId).execute();

  // Update the name field for the topic retrieved.
  topicToUpdate.setName("Semester 2");

  /* Call the patch endpoint and set the updateMask query parameter to the field that needs to
  be updated. */
  topic =
      service
          .courses()
          .topics()
          .patch(courseId, topicId, topicToUpdate)
          .set("updateMask", "name")
          .execute();

  /* Prints the updated topic. */
  System.out.printf("Topic '%s' updated.\n", topic.getName());
} catch (GoogleJsonResponseException e) {
  // TODO(developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The courseId or topicId does not exist: %s, %s.\n", courseId, topicId);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return topic;

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']))

ฟิลด์ Topic id และ updateTime สร้างขึ้นโดยเซิร์ฟเวอร์และอัปเดตด้วย API ไม่ได้

หมายเหตุ: หากคุณแพตช์ Topic โดยไม่เปลี่ยน name ระบบจะแสดงรหัสสถานะ HTTP 403 Forbidden

ลบหัวข้อ

คุณลบ Topic ที่มีอยู่ได้ด้วยเมธอด topics.delete() ดังที่แสดงในตัวอย่างต่อไปนี้

Java

classroom/snippets/src/main/java/DeleteTopic.java

ดูใน GitHub

try {
  service.courses().topics().delete(courseId, topicId).execute();
} catch (GoogleJsonResponseException e) {
  // TODO(developer) - handle error appropriately
  throw e;
} catch (Exception e) {
  throw e;
}