विषय मैनेज करें

विषय से जुड़ा संसाधन, स्ट्रीम आइटम के ऐसे ग्रुप को दिखाता है जिन्हें एक जैसी चीज़ों के आधार पर कैटगरी में बांटा गया है. जैसे, असाइन किया गया हफ़्ता या कोर्स का विषय.

हर विषय की पहचान, सर्वर से असाइन किए गए यूनीक आईडी से की जाती है. इस आईडी से, उस कोर्स का आईडी जुड़ा होता है जिससे विषय जुड़ा है. साथ ही, Classroom के यूज़र इंटरफ़ेस (यूआई) पर दिखने वाला विषय का असल नाम और पिछली बार अपडेट करने की तारीख और समय भी जुड़ा होता है.

विषय बनाना

किसी कोर्स में नया विषय बनाने के लिए, topics.create() तरीके का इस्तेमाल किया जा सकता है. इस तरीके के बारे में यहां दिए गए सैंपल में बताया गया है:

ध्यान दें: नाम फ़ील्ड को हमेशा भरना ज़रूरी है. साथ ही, यह खाली नहीं होना चाहिए. बाकी सभी फ़ील्ड में जानकारी देना ज़रूरी नहीं है.

JavaPython

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;

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

ध्यान दें: फ़िलहाल, एक गड़बड़ी की वजह से Classroom में, आखिर में स्पेस के साथ बनाए गए विषयों का इस्तेमाल नहीं किया जा सकता. समस्या ट्रैकर पर इस गड़बड़ी को फ़ॉलो करें.

विषय की जानकारी पाना

topics.get() तरीके का इस्तेमाल करके, किसी कोर्स के विषयों को वापस पाया जा सकता है. इसका उदाहरण यहां दिया गया है:

JavaPython

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;

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

कोर्स की सूची के लिए, topics.list() तरीके का इस्तेमाल करें, जैसा कि नीचे दिए गए सैंपल में दिखाया गया है:

JavaPython

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;

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

विषयों को अपडेट करना

किसी मौजूदा विषय का नाम अपडेट करने के लिए, topics.patch() तरीका अपनाएं. उदाहरण के लिए:

JavaPython

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;

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 और update_time फ़ील्ड को मैन्युअल तरीके से अपडेट नहीं किया जा सकता. अगर नाम में बदलाव किए बिना किसी विषय को पैच किया जाता है, तो HTTP 403 Forbidden स्टेटस कोड दिखता है.

विषय मिटाना

किसी मौजूदा विषय को मिटाने के लिए, 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;
}