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