과정 별칭 리소스를 사용하여 다른 이름으로 과정을 참조할 수 있습니다. 과정 별칭은 Google 클래스룸 과정 식별자와 외부 과정 식별자 간의 매핑입니다.
SIS에서 강의를 만들거나 강의를 SIS에 연결할 때마다 SIS의 courseID를 강의 별칭으로 사용하는 것이 좋습니다. Classroom API를 사용하면 과정의 id
매개변수를 별칭으로 지정하여 과정을 만들 때 바로 이 작업을 실행할 수 있습니다. 별칭이 이미 있는 경우 과정 생성이 실패하고 ALREADY_EXISTS (409)
오류가 표시됩니다. 이렇게 하면 동기화 프로그램에 버그가 있는 경우 중복 과정이 생성되지 않습니다.
별칭은 도메인 전체 및 프로젝트 전체의 두 가지 버전으로 제공됩니다.
- 도메인 전체 별칭은
d:
의 접두사를 사용하며, Classroom API를 사용하는 모든 사용자가 볼 수 있습니다. - 프로젝트 전반의 별칭은
p:
접두사를 사용하며 이를 만든 애플리케이션 (Developer Console 프로젝트)에서만 보고 사용할 수 있습니다.
별칭은 과정 식별자를 예상하는 API의 모든 위치에서 사용할 수 있습니다. 즉, API를 사용하여 별칭을 등록하면 해당 별칭을 사용하여 과정 및 명단 정보를 읽고 수정할 수 있습니다.
SIS 동기화 관점에서 보면 이는 과정의 SIS 내부 식별자를 과정의 도메인 전체 별칭으로 등록할 수 있음을 의미합니다. 이렇게 하면 SIS와 클래스룸을 모두 통합하는 모든 개발자가 SIS 식별자를 사용하여 클래스룸 데이터와 상호작용할 수 있습니다.
예를 들어 SIS 이름이 school
이고 SIS에서 특정 과정에 사용하는 내부 식별자가 math_101
라고 가정하면 별칭을 d:school_math_101
로 만들 수 있습니다.
새 과정의 별칭 추가
새 과정의 별칭을 추가하려면 courses.create()
요청을 할 때 course.id
를 원하는 별칭으로 설정합니다.
Apps Script
자바
Python
기존 과정의 별칭 추가
기존 과정에 별칭을 추가하려면 alias
를 원하는 별칭 이름으로 설정하고 courses.aliases.create()
메서드를 사용하면 됩니다.
Apps Script
자바
Python
과정 별칭 검색
다음 샘플과 같이 courses.aliases.list()
메서드를 사용하여 과정의 별칭을 가져올 수 있습니다.
.NET
자바
Python