과정 별칭을 사용하여 다른 이름으로 과정을 참조할 수 있습니다. 과정 별칭은 Google 클래스룸 과정 식별자와 외부 과정 식별자 간의 매핑 역할을 할 수 있습니다. 예를 들어 학생 정보 시스템 (SIS)의 과정 ID와 일치하도록 과정 별칭을 설정할 수 있습니다.
과정 별칭에는 도메인 전체와 프로젝트 전체의 두 가지 형식이 있습니다.
도메인 전체 별칭 은
d:접두어를 사용하며 클래스룸 API를 사용하는 모든 사용자가 볼 수 있습니다. 도메인 네임스페이스는 모든 사용자가 액세스해야 하지만 특정 프로그램에 국한되지 않는 별칭을 만드는 데 유용합니다. 예를 들어 MATH 127 및 COMSCI 127과 같은 과정의 대체 목록은 도메인 네임스페이스에서 만들어야 합니다. 도메인 네임스페이스의 별칭은 도메인 관리자만 만들 수 있지만 도메인의 모든 사용자에게 표시됩니다.프로젝트 전체 별칭 은
p:접두어를 사용하며 이를 만든 Google Cloud 프로젝트만 보고 사용할 수 있습니다. 개발자 프로젝트 네임스페이스는 애플리케이션과 관련된 별칭을 관리하는 데 유용합니다. 예를 들어 과정에 대체 식별자를 사용하는 애플리케이션은 식별자를 클래스룸 과정에 매핑하는 별칭을 만들 수 있습니다. 이 네임스페이스에서 만든 별칭은 특정 Google Cloud 프로젝트에 연결됩니다. 애플리케이션의 모든 사용자는 해당 애플리케이션의 개발자 프로젝트 네임스페이스에서 별칭을 만들고 볼 수 있습니다.
과정 별칭은 모든 클래스룸 API 엔드포인트의 클래스룸 과정 ID 대신 사용할 수 있습니다. 즉, 별칭을 사용하여 과정 및 출석부 정보를 읽고 수정할 수 있습니다.
학생 정보 시스템과 동기화할 별칭 사용
과정의 SIS 내부 식별자를 과정의 도메인 전체 별칭으로 등록할 수 있습니다. 이렇게 하면 SIS와 클래스룸 모두와 통합되는 모든 개발자가 SIS 식별자를 사용하여 클래스룸 데이터와 상호작용할 수 있습니다.
SIS에서 과정을 만들거나 과정을 SIS에 연결하는 경우 SIS의 과정 ID를 과정 별칭으로 사용하는 것이 좋습니다. 과정을 만들 때 courses.create() 메서드를 사용하여 요청의
id 필드에서 별칭을 지정할 수 있습니다. 별칭이 이미 있는 경우 409 ALREADY_EXISTS 오류와 함께 과정 생성이 실패합니다. 이렇게 하면 동기화 프로그램에 문제가 있는 경우 중복된 과정이 생성되지 않습니다.
예를 들어 SIS 이름이 school이고 SIS에서 특정 과정에 사용하는 내부 식별자
가 math_101이라고 가정하면 d:school_math_101로 별칭을 만들 수 있습니다.
새 과정의 별칭 추가
새 과정의 별칭을 추가하려면 course.id을(를) 별칭으로 설정할 때
courses.create() 요청을 합니다.
Apps Script
자바
Python
기존 과정의 별칭 추가
기존 과정에 별칭을 추가하려면 alias 필드
를 설정하고 courses.aliases.create() 메서드를 사용하면 됩니다.
Apps Script
자바
Python
과정 별칭 가져오기
다음 샘플과 같이
courses.aliases.list() 메서드를 사용하여 과정의 별칭을 가져올 수 있습니다.
.NET
자바
Python