과정 리소스는 '수학 127'과 같은 클래스와 여기에 할당된 교사, 학생 출석부, 메타데이터를 나타냅니다.
각 과정은 서버에서 할당한 고유 ID로 식별됩니다. 또한 이름은 과정과 연결될 수 있으며 고유 ID 대신 사용될 수 있습니다. 별칭이라고 하는 각 이름은 생성 및 조회 권한을 제한하는 네임스페이스에 있습니다.
2개의 네임스페이스가 지원됩니다.
- 도메인: 도메인 네임스페이스는 모든 사용자가 액세스해야 하지만 특정 프로그램에 국한되지 않는 별칭을 만드는 데 유용합니다. 예를 들어 MATH 127 및 COMSCI 127과 같은 과정의 대체 등록정보를 도메인 네임스페이스에 만들어야 합니다. 도메인 네임스페이스의 별칭은 도메인 관리자만 만들 수 있지만 도메인의 모든 사용자가 볼 수 있습니다.
- 개발자 프로젝트: 개발자 프로젝트 네임스페이스는 애플리케이션에 특정한 별칭을 관리하는 데 유용합니다. 예를 들어 강의에 대체 식별자를 사용하는 애플리케이션은 별칭을 만들어 클래스룸 과정에 식별자를 매핑할 수 있습니다. 이 네임스페이스에서 생성된 별칭은 특정 Google API 콘솔 프로젝트에 연결됩니다. 애플리케이션의 모든 사용자는 애플리케이션 개발자 프로젝트의 네임스페이스에서 별칭을 만들고 볼 수 있습니다.
과정 만들기
다음 샘플과 같이 courses.create() 메서드를 사용하여 과정을 추가할 수 있습니다.
.NET
classroom/snippets/클래스룸스니펫/CreateCourse.cs
using Google;
using Google.Apis.Auth.OAuth2;
using Google.Apis.Classroom.v1;
using Google.Apis.Classroom.v1.Data;
using Google.Apis.Services;
using System;
namespace ClassroomSnippets
{
// Class to demonstrate the use of Classroom Create Course API
public class CreateCourse
{
/// <summary>
/// Creates a new course with description.
/// </summary>
/// <returns>newly created course</returns>
public static Course ClassroomCreateCourse()
{
try
{
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
GoogleCredential credential = GoogleCredential.GetApplicationDefault()
.CreateScoped(ClassroomService.Scope.ClassroomCourses);
// Create Classroom API service.
var service = new ClassroomService(new BaseClientService.Initializer
{
HttpClientInitializer = credential,
ApplicationName = "Classroom API Snippets"
});
// Create a new course with description.
var course = new Course
{
Name = "10th Grade Biology",
Section = "Period 2",
DescriptionHeading = "Welcome to 10th Grade Biology",
Description = "We'll be learning about about the structure of living creatures "
+ "from a combination of textbooks, guest lectures, and lab work. Expect "
+ "to be excited!",
Room = "301",
OwnerId = "me",
CourseState = "PROVISIONED"
};
course = service.Courses.Create(course).Execute();
// Prints the new created course Id and name.
Console.WriteLine("Course created: {0} ({1})", course.Name, course.Id);
return course;
}
catch (Exception e)
{
// TODO(developer) - handle error appropriately
if (e is AggregateException)
{
Console.WriteLine("Credential Not found");
}
else if (e is GoogleApiException)
{
Console.WriteLine("OwnerId not specified.");
}
else
{
throw;
}
}
return null;
}
}
}
Apps Script
classroom/snippets/createCourse.gs
/**
* Creates 10th Grade Biology Course.
* @see https://developers.google.com/classroom/reference/rest/v1/courses/create
* return {string} Id of created course
*/
function createCourse() {
let course = {
name: '10th Grade Biology',
section: 'Period 2',
descriptionHeading: 'Welcome to 10th Grade Biology',
description: 'We\'ll be learning about the structure of living creatures from a combination ' +
'of textbooks, guest lectures, and lab work. Expect to be excited!',
room: '301',
ownerId: 'me',
courseState: 'PROVISIONED'
};
try {
// Create the course using course details.
course = Classroom.Courses.create(course);
console.log('Course created: %s (%s)', course.name, course.id);
return course.id;
} catch (err) {
// TODO (developer) - Handle Courses.create() exception
console.log('Failed to create course %s with an error %s', course.name, err.message);
}
}
Go
classroom/snippets/createCourse.go
c := &classroom.Course{
Name: "10th Grade Biology",
Section: "Period 2",
DescriptionHeading: "Welcome to 10th Grade Biology",
Description: "We'll be learning about about the structure of living creatures from a combination of textbooks, guest lectures, and lab work. Expect to be excited!",
Room: "301",
OwnerId: "me",
CourseState: "PROVISIONED",
}
course, err := srv.Courses.Create(c).Do()
if err != nil {
log.Fatalf("Course unable to be created %v", err)
}
자바
classroom/snippets/src/main/java/CreateCourse.java
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.classroom.Classroom;
import com.google.api.services.classroom.ClassroomScopes;
import com.google.api.services.classroom.model.Course;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.ArrayList;
import java.util.Arrays;
/* Class to demonstrate the use of Classroom Create Course API */
public class CreateCourse {
/* Scopes required by this API call. If modifying these scopes, delete your previously saved
tokens/ folder. */
static ArrayList<String> SCOPES =
new ArrayList<>(Arrays.asList(ClassroomScopes.CLASSROOM_COURSES));
/**
* Creates a course
*
* @return newly created course
* @throws IOException - if credentials file not found.
* @throws GeneralSecurityException - if a new instance of NetHttpTransport was not created.
*/
public static Course createCourse() throws GeneralSecurityException, IOException {
// Create the classroom API client.
final NetHttpTransport HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
Classroom service =
new Classroom.Builder(
HTTP_TRANSPORT,
GsonFactory.getDefaultInstance(),
ClassroomCredentials.getCredentials(HTTP_TRANSPORT, SCOPES))
.setApplicationName("Classroom samples")
.build();
Course course = null;
try {
// Adding a new course with description. Set CourseState to `ACTIVE`. Possible values of
// CourseState can be found here:
// https://developers.google.com/classroom/reference/rest/v1/courses#coursestate
course =
new Course()
.setName("10th Grade Biology")
.setSection("Period 2")
.setDescriptionHeading("Welcome to 10th Grade Biology")
.setDescription(
"We'll be learning about about the structure of living creatures "
+ "from a combination of textbooks, guest lectures, and lab work. Expect "
+ "to be excited!")
.setRoom("301")
.setOwnerId("me")
.setCourseState("ACTIVE");
course = service.courses().create(course).execute();
// Prints the new created course Id and name
System.out.printf("Course created: %s (%s)\n", course.getName(), course.getId());
} catch (GoogleJsonResponseException e) {
GoogleJsonError error = e.getDetails();
if (error.getCode() == 400) {
System.err.println("Unable to create course, ownerId not specified.\n");
} else {
throw e;
}
}
return course;
}
}
2,399필리핀
classroom/snippets/src/클래스룸CreateCourse.php
use Google\Client;
use Google\Service\Classroom;
use Google\Service\Classroom\Course;
use Google\Service\Exception;
function createCourse()
{
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
$client = new Client();
$client->useApplicationDefaultCredentials();
$client->addScope("https://www.googleapis.com/auth/classroom.courses");
$service = new Classroom($client);
try {
$course = new Course([
'name' => '10th Grade Biology',
'section' => 'Period 2',
'descriptionHeading' => 'Welcome to 10th Grade Biology',
'description' => 'We\'ll be learning about about the structure of living ' .
'creatures from a combination of textbooks, guest ' .
'lectures, and lab work. Expect to be excited!',
'room' => '301',
'ownerId' => 'me',
'courseState' => 'PROVISIONED'
]);
$course = $service->courses->create($course);
printf("Course created: %s (%s)\n", $course->name, $course->id);
return $course;
} catch (Exception $e) {
echo 'Message: ' . $e->getMessage();
}
}
Python
classroom/snippets/classroom_create_course.py
from __future__ import print_function
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
def classroom_create_course():
"""
Creates the courses the user has access to.
Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity
for guides on implementing OAuth2 for the application.
"""
creds, _ = google.auth.default()
# pylint: disable=maybe-no-member
try:
service = build('classroom', 'v1', credentials=creds)
course = {
'name': '10th Grade Mathematics Probability-2',
'section': 'Period 3',
'descriptionHeading': 'Welcome to 10th Grade Mathematics',
'description': """We'll be learning about about the
polynomials from a
combination of textbooks and guest lectures.
Expect to be excited!""",
'room': '302',
'ownerId': 'me',
'courseState': 'PROVISIONED'
}
# pylint: disable=maybe-no-member
course = service.courses().create(body=course).execute()
print(f"Course created: {(course.get('name'), course.get('id'))}")
return course
except HttpError as error:
print(f"An error occurred: {error}")
return error
if __name__ == '__main__':
classroom_create_course()
과정을 만들 때 선택적으로 과정 설명, 시간 또는 위치와 같은 메타데이터를 추가할 수 있습니다.
과정을 만들려면 요청하는 사용자에게 사용자 프로필에 적절한 권한이 있어야 합니다.
과정은 기본적으로 courseState가 PROVISIONED로 설정된 상태로 생성되지만 ACTIVE로 재정의할 수 있습니다. 과정이 PROVISIONED 상태로 생성된 경우 ownerId에서 식별된 교사가 클래스룸 UI에서 수업을 수락하거나 API를 통해 과정을 업데이트해야 courseState이 ACTIVE로 변경되고 학생들이 이를 사용할 수 있습니다.
과정 세부정보 가져오기
다음 샘플과 같이 courses.get() 메서드를 사용하여 단일 과정의 메타데이터를 검색할 수 있습니다.
.NET
classroom/snippets/클래스룸스니펫/GetCourse.cs
using Google;
using Google.Apis.Auth.OAuth2;
using Google.Apis.Classroom.v1;
using Google.Apis.Classroom.v1.Data;
using Google.Apis.Services;
using System;
namespace ClassroomSnippets
{
// Class to demonstrate the use of Classroom Get Course API
public class GetCourse
{
/// <summary>
/// Retrieve a single course's metadata.
/// </summary>
/// <param name="courseId">Id of the course.</param>
/// <returns>a course, null otherwise.</returns>
public static Course ClassroomGetCourse(string courseId)
{
try
{
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
GoogleCredential credential = GoogleCredential.GetApplicationDefault()
.CreateScoped(ClassroomService.Scope.ClassroomCourses);
// Create Classroom API service.
var service = new ClassroomService(new BaseClientService.Initializer
{
HttpClientInitializer = credential,
ApplicationName = "Classroom Snippets"
});
// Get the course details using course id
Course course = service.Courses.Get(courseId).Execute();
Console.WriteLine("Course '{0}' found.\n", course.Name);
return course;
}
catch (Exception e)
{
// TODO(developer) - handle error appropriately
if (e is AggregateException)
{
Console.WriteLine("Credential Not found");
}
else if (e is GoogleApiException)
{
Console.WriteLine("Course does not exist.");
}
else
{
throw;
}
}
return null;
}
}
}
Apps Script
classroom/snippets/getCourse.gs
/**
* Retrieves course by id.
* @param {string} courseId
* @see https://developers.google.com/classroom/reference/rest/v1/courses/get
*/
function getCourse(courseId) {
try {
// Get the course details using course id
const course = Classroom.Courses.get(courseId);
console.log('Course "%s" found. ', course.name);
} catch (err) {
// TODO (developer) - Handle Courses.get() exception of Handle Classroom API
console.log('Failed to found course %s with error %s ', courseId, err.message);
}
}
Go
classroom/snippets/getCourse.go
ctx := context.Background()
srv, err := classroom.NewService(ctx, option.WithHTTPClient(client))
if err != nil {
log.Fatalf("Unable to create classroom Client %v", err)
}
id := "123456"
course, err := srv.Courses.Get(id).Do()
if err != nil {
log.Fatalf("Course unable to be retrieved %v", err)
}
자바
classroom/snippets/src/main/java/GetCourse.java
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.classroom.Classroom;
import com.google.api.services.classroom.ClassroomScopes;
import com.google.api.services.classroom.model.Course;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.ArrayList;
import java.util.Arrays;
/* Class to demonstrate the use of Classroom Get Course API */
public class GetCourse {
/* Scopes required by this API call. If modifying these scopes, delete your previously saved
tokens/ folder. */
static ArrayList<String> SCOPES =
new ArrayList<>(Arrays.asList(ClassroomScopes.CLASSROOM_COURSES));
/**
* Retrieve a single course's metadata.
*
* @param courseId - Id of the course to return.
* @return a course
* @throws IOException - if credentials file not found.
* @throws GeneralSecurityException - if a new instance of NetHttpTransport was not created.
*/
public static Course getCourse(String courseId) throws GeneralSecurityException, IOException {
// Create the classroom API client.
final NetHttpTransport HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
Classroom service =
new Classroom.Builder(
HTTP_TRANSPORT,
GsonFactory.getDefaultInstance(),
ClassroomCredentials.getCredentials(HTTP_TRANSPORT, SCOPES))
.setApplicationName("Classroom samples")
.build();
Course course = null;
try {
course = service.courses().get(courseId).execute();
System.out.printf("Course '%s' found.\n", course.getName());
} catch (GoogleJsonResponseException e) {
// TODO(developer) - handle error appropriately
GoogleJsonError error = e.getDetails();
if (error.getCode() == 404) {
System.out.printf("Course with ID '%s' not found.\n", courseId);
} else {
throw e;
}
}
return course;
}
}
2,399필리핀
classroom/snippets/src/클래스룸GetCourse.php
use Google\Client;
use Google\Service\Classroom;
use Google\Service\Exception;
function getCourse($courseId)
{
/* Load pre-authorized user credentials from the environment.
TODO (developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
$client = new Client();
$client->useApplicationDefaultCredentials();
$client->addScope("https://www.googleapis.com/auth/classroom.courses");
$service = new Classroom($client);
try {
$course = $service->courses->get($courseId);
printf("Course '%s' found.\n", $course->name);
return $course;
} catch (Exception $e) {
if ($e->getCode() == 404) {
printf("Course with ID '%s' not found.\n", $courseId);
} else {
throw $e;
}
}
}
Python
classroom/snippets/classroom_get_course.py
from __future__ import print_function
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
def classroom_get_course(course_id):
"""
Prints the name of the with specific course_id.
Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity
for guides on implementing OAuth2 for the application.
"""
creds, _ = google.auth.default()
# pylint: disable=maybe-no-member
course = None
try:
service = build('classroom', 'v1', credentials=creds)
course = service.courses().get(id=course_id).execute()
print(f"Course found : {course.get('name')}")
except HttpError as error:
print(f"An error occurred: {error}")
print(f"Course not found: {course_id}")
return error
return course
if __name__ == '__main__':
# Put the course_id of course whose information needs to be fetched.
classroom_get_course('course_id')
과정 목록을 보려면 다음 샘플과 같이 courses.list()를 사용하세요.
.NET
classroom/snippets/클래스룸스니펫/ListCourses.cs
using Google.Apis.Auth.OAuth2;
using Google.Apis.Classroom.v1;
using Google.Apis.Classroom.v1.Data;
using Google.Apis.Services;
using System;
using System.Collections.Generic;
namespace ClassroomSnippets
{
// Class to demonstrate the use of Classroom List Course API
public class ListCourses
{
/// <summary>
/// Retrieves all courses with metadata.
/// </summary>
/// <returns>list of courses with its metadata, null otherwise.</returns>
public static List<Course> ClassroomListCourses()
{
try
{
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
GoogleCredential credential = GoogleCredential.GetApplicationDefault()
.CreateScoped(ClassroomService.Scope.ClassroomCourses);
// Create Classroom API service.
var service = new ClassroomService(new BaseClientService.Initializer
{
HttpClientInitializer = credential,
ApplicationName = "Classroom Snippets"
});
string pageToken = null;
var courses = new List<Course>();
do
{
var request = service.Courses.List();
request.PageSize = 100;
request.PageToken = pageToken;
var response = request.Execute();
courses.AddRange(response.Courses);
pageToken = response.NextPageToken;
} while (pageToken != null);
Console.WriteLine("Courses:");
foreach (var course in courses)
{
// Print the courses available in classroom
Console.WriteLine("{0} ({1})", course.Name, course.Id);
}
return courses;
}
catch (Exception e)
{
// TODO(developer) - handle error appropriately
if (e is AggregateException)
{
Console.WriteLine("Credential Not found");
}
else if (e is ArgumentNullException)
{
Console.WriteLine("No courses found.");
}
else
{
throw;
}
}
return null;
}
}
}
Apps Script
classroom/snippets/listCourses.gs
/**
* Lists all course names and ids.
* @see https://developers.google.com/classroom/reference/rest/v1/courses/list
*/
function listCourses() {
let courses = [];
const pageToken = null;
const optionalArgs = {
pageToken: pageToken,
pageSize: 100
};
try {
const response = Classroom.Courses.list(optionalArgs);
courses = response.courses;
if (courses.length === 0) {
console.log('No courses found.');
return;
}
// Print the courses available in classroom
console.log('Courses:');
for ( const course in courses) {
console.log('%s (%s)', courses[course].name, courses[course].id);
}
} catch (err) {
// TODO (developer) - Handle exception
console.log('Failed with error %s', err.message);
}
}
자바
classroom/snippets/src/main/java/ListCourses.java
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.classroom.Classroom;
import com.google.api.services.classroom.ClassroomScopes;
import com.google.api.services.classroom.model.Course;
import com.google.api.services.classroom.model.ListCoursesResponse;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
/* Class to demonstrate the use of Classroom List Course API */
public class ListCourses {
/* Scopes required by this API call. If modifying these scopes, delete your previously saved
tokens/ folder. */
static ArrayList<String> SCOPES =
new ArrayList<>(Arrays.asList(ClassroomScopes.CLASSROOM_COURSES));
/**
* Retrieves all courses with metadata
*
* @return list of courses with its metadata
* @throws IOException - if credentials file not found.
* @throws GeneralSecurityException - if a new instance of NetHttpTransport was not created.
*/
public static List<Course> listCourses() throws GeneralSecurityException, IOException {
// Create the classroom API client.
final NetHttpTransport HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
Classroom service =
new Classroom.Builder(
HTTP_TRANSPORT,
GsonFactory.getDefaultInstance(),
ClassroomCredentials.getCredentials(HTTP_TRANSPORT, SCOPES))
.setApplicationName("Classroom samples")
.build();
String pageToken = null;
List<Course> courses = new ArrayList<>();
try {
do {
ListCoursesResponse response =
service.courses().list().setPageSize(100).setPageToken(pageToken).execute();
courses.addAll(response.getCourses());
pageToken = response.getNextPageToken();
} while (pageToken != null);
if (courses.isEmpty()) {
System.out.println("No courses found.");
} else {
System.out.println("Courses:");
for (Course course : courses) {
System.out.printf("%s (%s)\n", course.getName(), course.getId());
}
}
} catch (NullPointerException ne) {
// TODO(developer) - handle error appropriately
System.err.println("No courses found.\n");
}
return courses;
}
}
2,399필리핀
classroom/snippets/src/클래스룸ListCourses.php
use Google\Service\Classroom;
use Google\Client;
function listCourses(): array
{
/* Load pre-authorized user credentials from the environment.
TODO (developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
$client = new Client();
$client->useApplicationDefaultCredentials();
$client->addScope("https://www.googleapis.com/auth/classroom.courses");
$service = new Classroom($client);
$courses = [];
$pageToken = '';
do {
$params = [
'pageSize' => 100,
'pageToken' => $pageToken
];
$response = $service->courses->listCourses($params);
$courses = array_merge($courses, $response->courses);
$pageToken = $response->nextPageToken;
} while (!empty($pageToken));
if (count($courses) == 0) {
print "No courses found.\n";
} else {
print "Courses:\n";
foreach ($courses as $course) {
printf("%s (%s)\n", $course->name, $course->id);
}
}
return $courses;
}
Python
classroom/snippets/classroom_list_courses.py
from __future__ import print_function
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
def classroom_list_courses():
"""
Prints the list of the courses the user has access to.
Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity
for guides on implementing OAuth2 for the application.
"""
creds, _ = google.auth.default()
try:
service = build('classroom', 'v1', credentials=creds)
courses = []
page_token = None
while True:
# pylint: disable=maybe-no-member
response = service.courses().list(pageToken=page_token,
pageSize=100).execute()
courses.extend(response.get('courses', []))
page_token = response.get('nextPageToken', None)
if not page_token:
break
if not courses:
print("No courses found.")
return
print("Courses:")
for course in courses:
print(f"{course.get('name'), course.get('id')}")
return courses
except HttpError as error:
print(f"An error occurred: {error}")
return error
if __name__ == '__main__':
print('Courses available are-------')
classroom_list_courses()
특정 사용자의 강의만 나열할 수도 있습니다. 자세한 내용은 사용자의 과정 검색을 참조하세요.
수업 정보 업데이트
과정을 만든 후에 과정 메타데이터 중 일부를 업데이트할 수 있습니다. 과정을 만든 후 언제든지 다음과 같은 필드를 업데이트할 수 있습니다.
namesectiondescriptionHeadingdescriptionroomcourseStateownerId
과정의 모든 필드를 업데이트하려면 다음 샘플과 같이 courses.update() 메서드를 사용합니다.
.NET
classroom/snippets/클래스룸스니펫/UpdateCourse.cs
using Google.Apis.Auth.OAuth2;
using Google.Apis.Classroom.v1;
using Google.Apis.Classroom.v1.Data;
using Google.Apis.Services;
using System;
using System.Net;
using Google;
namespace ClassroomSnippets
{
// Class to demonstrate the use of Classroom Update Course API
public class UpdateCourse
{
/// <summary>
/// Update one field of course
/// </summary>
/// <param name="courseId"></param>
/// <returns></returns>
/// <exception cref="GoogleApiException"></exception>
public static Course ClassroomUpdateCourse(string courseId)
{
try
{
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
GoogleCredential credential = GoogleCredential.GetApplicationDefault()
.CreateScoped(ClassroomService.Scope.ClassroomCourses);
// Create Classroom API service.
var service = new ClassroomService(new BaseClientService.Initializer
{
HttpClientInitializer = credential,
ApplicationName = "Classroom API Snippet"
});
Course course = service.Courses.Get(courseId).Execute();
course.Section = "Period 3";
course.Room = "302";
course = service.Courses.Update(course, courseId).Execute();
Console.WriteLine("Course '{0}' updated.\n", course.Name);
return course;
}
catch (Exception e)
{
// TODO(developer) - handle error appropriately
if (e is AggregateException)
{
Console.WriteLine("Credential Not found");
}
else if (e is GoogleApiException)
{
Console.WriteLine("Failed to update the course. Error message: {0}", e.Message);
}
else
{
throw;
}
}
return null;
}
}
}
Apps Script
classroom/snippets/courseUpdate.gs
/**
* Updates the section and room of Google Classroom.
* @param {string} courseId
* @see https://developers.google.com/classroom/reference/rest/v1/courses/update
*/
function courseUpdate(courseId) {
try {
// Get the course using course ID
let course = Classroom.Courses.get(courseId);
course.section = 'Period 3';
course.room = '302';
// Update the course
course = Classroom.Courses.update(course, courseId);
console.log('Course "%s" updated.', course.name);
} catch (e) {
// TODO (developer) - Handle exception
console.log('Failed to update the course with error %s', e.message);
}
}
자바
classroom/snippets/src/main/java/UpdateCourse.java
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.classroom.Classroom;
import com.google.api.services.classroom.ClassroomScopes;
import com.google.api.services.classroom.model.Course;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.ArrayList;
import java.util.Arrays;
/* Class to demonstrate the use of Classroom Update Course API */
public class UpdateCourse {
/* Scopes required by this API call. If modifying these scopes, delete your previously saved
tokens/ folder. */
static ArrayList<String> SCOPES =
new ArrayList<>(Arrays.asList(ClassroomScopes.CLASSROOM_COURSES));
/**
* Updates a course's metadata.
*
* @param courseId - Id of the course to update.
* @return updated course
* @throws IOException - if credentials file not found.
* @throws GeneralSecurityException - if a new instance of NetHttpTransport was not created.
*/
public static Course updateCourse(String courseId) throws GeneralSecurityException, IOException {
// Create the classroom API client.
final NetHttpTransport HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
Classroom service =
new Classroom.Builder(
HTTP_TRANSPORT,
GsonFactory.getDefaultInstance(),
ClassroomCredentials.getCredentials(HTTP_TRANSPORT, SCOPES))
.setApplicationName("Classroom samples")
.build();
Course course = null;
try {
// Updating the section and room in a course
course = service.courses().get(courseId).execute();
course.setSection("Period 3");
course.setRoom("302");
course = service.courses().update(courseId, course).execute();
// Prints the updated course
System.out.printf("Course '%s' updated.\n", course.getName());
} catch (GoogleJsonResponseException e) {
// TODO(developer) - handle error appropriately
GoogleJsonError error = e.getDetails();
if (error.getCode() == 404) {
System.err.println("Course does not exist.\n");
} else {
throw e;
}
}
return course;
}
}
2,399필리핀
classroom/snippets/src/클래스룸UpdateCourse.php
use Google\Client;
use Google\Service\Classroom;
function updateCourse($courseId)
{
/* Load pre-authorized user credentials from the environment.
TODO (developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
$client = new Client();
$client->useApplicationDefaultCredentials();
$client->addScope("https://www.googleapis.com/auth/classroom.courses");
$service = new Classroom($client);
$course = $service->courses->get($courseId);
$course->section = 'Period 3';
$course->room = '302';
$course = $service->courses->update($courseId, $course);
printf("Course '%s' updated.\n", $course->name);
return $course;
}
Python
classroom/snippets/classroom_update_course.py
from __future__ import print_function
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
def classroom_update_course(course_id):
"""
Updates the courses names the user has access to.
Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity
for guides on implementing OAuth2 for the application.
"""
# pylint: disable=maybe-no-member
creds, _ = google.auth.default()
try:
service = build('classroom', 'v1', credentials=creds)
# Updates the section and room of Google Classroom.
course = service.courses().get(id=course_id).execute()
course['name'] = '10th Grade Physics - Light'
course['section'] = 'Period 4'
course['room'] = '410'
course = service.courses().update(id=course_id, body=course).execute()
print(f" Updated Course is: {course.get('name')}")
return course
except HttpError as error:
print(f"An error occurred: {error}")
return error
if __name__ == '__main__':
# Put the course_id of course whose course needs to be updated.
classroom_update_course('course_id')
다음 샘플과 같이 courses.patch() 메서드를 사용하여 특정 필드를 업데이트할 수도 있습니다.
.NET
classroom/snippets/클래스룸스니펫/PatchCourse.cs
using Google.Apis.Auth.OAuth2;
using Google.Apis.Classroom.v1;
using Google.Apis.Classroom.v1.Data;
using Google.Apis.Services;
using System;
using Google;
namespace ClassroomSnippets
{
// Class to demonstrate the use of Classroom Patch Course API
public class PatchUpdate
{
/// <summary>
/// Updates one or more fields in a course.
/// </summary>
/// <param name="courseId"></param>
/// <returns></returns>
/// <exception cref="GoogleApiException"></exception>
public static Course ClassroomPatchUpdate(string courseId)
{
try
{
/* Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
GoogleCredential credential = GoogleCredential.GetApplicationDefault()
.CreateScoped(ClassroomService.Scope.ClassroomCourses);
// Create Classroom API service.
var service = new ClassroomService(new BaseClientService.Initializer
{
HttpClientInitializer = credential,
ApplicationName = "Classroom API Snippet"
});
var course = new Course
{
Section = "Period 3",
Room = "302"
};
// Updates one or more fields of course.
var request = service.Courses.Patch(course, courseId);
request.UpdateMask = "section,room";
course = request.Execute();
Console.WriteLine("Course '{0}' updated.\n", course.Name);
return course;
}
catch (Exception e)
{
// TODO(developer) - handle error appropriately
if (e is AggregateException)
{
Console.WriteLine("Credential Not found");
}
else if (e is GoogleApiException)
{
Console.WriteLine("Failed to update the course. Error message: {0}", e.Message);
}
else
{
throw ;
}
}
return null;
}
}
}
Apps Script
classroom/snippets/patchCourse.gs
/**
* Updates the section and room of Google Classroom.
* @param {string} courseId
* @see https://developers.google.com/classroom/reference/rest/v1/courses/patch
*/
function coursePatch(courseId) {
let course = {
'section': 'Period 3',
'room': '302'
};
const mask = {
updateMask: 'section,room'
};
try {
// Update section and room in course.
course = Classroom.Courses.patch(body=course, id=courseId, updateMask=mask);
console.log('Course "%s" updated.', course.name);
} catch (err) {
// TODO (developer) - Handle Courses.patch() exception
console.log('Failed to update the course. Error message: %s', err.message);
}
}
자바
classroom/snippets/src/main/java/PatchCourse.java
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.classroom.Classroom;
import com.google.api.services.classroom.ClassroomScopes;
import com.google.api.services.classroom.model.Course;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.ArrayList;
import java.util.Arrays;
/* Class to demonstrate the use of Classroom Patch Course API */
public class PatchCourse {
/* Scopes required by this API call. If modifying these scopes, delete your previously saved
tokens/ folder. */
static ArrayList<String> SCOPES =
new ArrayList<>(Arrays.asList(ClassroomScopes.CLASSROOM_COURSES));
/**
* Updates one or more fields in a course.
*
* @param courseId - Id of the course to update.
* @return updated course
* @throws IOException - if credentials file not found.
* @throws GeneralSecurityException - if a new instance of NetHttpTransport was not created.
*/
public static Course patchCourse(String courseId) throws GeneralSecurityException, IOException {
// Create the classroom API client.
final NetHttpTransport HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
Classroom service =
new Classroom.Builder(
HTTP_TRANSPORT,
GsonFactory.getDefaultInstance(),
ClassroomCredentials.getCredentials(HTTP_TRANSPORT, SCOPES))
.setApplicationName("Classroom samples")
.build();
Course course = null;
try {
course = new Course().setSection("Period 3").setRoom("302");
course = service.courses().patch(courseId, course).setUpdateMask("section,room").execute();
System.out.printf("Course '%s' updated.\n", course.getName());
} catch (GoogleJsonResponseException e) {
// TODO(developer) - handle error appropriately
GoogleJsonError error = e.getDetails();
if (error.getCode() == 404) {
System.err.println("Course does not exist.\n");
} else {
throw e;
}
}
return course;
}
}
2,399필리핀
classroom/snippets/src/클래스룸PatchCourse.php
use Google\Service\Classroom;
use Google\Service\Classroom\Course;
use Google\Client;
function patchCourse($courseId)
{
/* Load pre-authorized user credentials from the environment.
TODO (developer) - See https://developers.google.com/identity for
guides on implementing OAuth2 for your application. */
$client = new Client();
$client->useApplicationDefaultCredentials();
$client->addScope("https://www.googleapis.com/auth/classroom.courses");
$service = new Classroom($client);
try {
$course = new Course([
'section' => 'Period 3',
'room' => '302'
]);
$params = ['updateMask' => 'section,room'];
$course = $service->courses->patch($courseId, $course, $params);
printf("Course '%s' updated.\n", $course->name);
return $course;
} catch (Exception $e) {
echo 'Message: ' . $e->getMessage();
}
}
Python
classroom/snippets/classroom_patch_course.py
from __future__ import print_function
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
def classroom_patch_course(course_id):
"""
Patch new course with existing course in the account the user has access to.
Load pre-authorized user credentials from the environment.
TODO(developer) - See https://developers.google.com/identity
for guides on implementing OAuth2 for the application.
"""
# pylint: disable=maybe-no-member
creds, _ = google.auth.default()
try:
service = build('classroom', 'v1', credentials=creds)
course = {
'section': 'Period 3',
'room': '313'
}
course = service.courses().patch(id=course_id,
updateMask='section,room',
body=course).execute()
print(f" Course updated are: {course.get('name')}")
return course
except HttpError as error:
print(f"An error occurred: {error}")
if __name__ == '__main__':
# Put the course_id of course with whom we need to patch some extra
# information.
classroom_patch_course('course_id')
수업 소유권 이전
도메인 관리자는 다음 메서드를 호출하여 도메인 내 교사 간에 수업 소유권을 이전할 수 있습니다.
아직 공동 교사가 아닌 경우 먼저
teachers.create()를 호출하여 교사를 강의에 추가합니다.그런 다음
courses.patch()를 호출하고 요청 객체의ownerId필드에 공동 교사의 이메일 또는 사용자 ID를 지정하여 과정 소유자를 업데이트합니다.