Konuları Yönetin

Konu kaynağı, benzerlik (ör. atanan hafta veya kurs konusu) temel alınarak sınıflandırılmış bir akış öğesi grubunu temsil eder.

Her konu, sunucu tarafından atanan benzersiz bir kimlikle tanımlanır. Bu kimlikle ilişkili olarak, konunun ait olduğu kurs kimliği, Classroom kullanıcı arayüzünde gösterilen gerçek konu adı ve son güncellemenin tarihi ve saati yer alır.

Konu oluşturma

Aşağıdaki örnekte gösterildiği gibi topics.create() yöntemini kullanarak bir kursta yeni bir konu oluşturabilirsiniz:

Not: Ad alanı her zaman zorunludur ve boş olmayan bir dize olmalıdır. Diğer tüm alanlar isteğe bağlıdır.

JavaPython

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

GitHub'da göster

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;

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

Not: Şu anda, sonunda boşluk bulunan konuların Classroom'da kullanılamamasına neden olan bir hata mevcuttur. Sorun İzleyici'de bu hatayı takip edin.

Konu ayrıntılarını alma

Aşağıdaki örnekte gösterildiği gibi, topics.get() yöntemiyle ilgili bir kursun konularını alabilirsiniz:

JavaPython

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

GitHub'da göster

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;

response = service.courses().topics().get(
  courseId=<course ID or alias>,
  id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))

Kursların listesi için aşağıdaki örnekte gösterildiği gibi topics.list() yöntemini kullanın:

JavaPython

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

GitHub'da göster

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;

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:

JavaPython

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

GitHub'da göster

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;

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

Not: Konu kimliği ve güncelleme zamanı alanları manuel olarak güncellenemez. Bir konuyu adını değiştirmeden düzeltirseniz HTTP 403 Forbidden durum kodu döndürülür.

Konuları silin

Mevcut bir konuyu, aşağıdaki örnekte gösterildiği gibi topics.delete() yöntemiyle silebilirsiniz:

Java

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

GitHub'da göster

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