REST Resource: courses.aliases

리소스: CourseAlias

과정의 대체 식별자입니다.

별칭은 과정을 고유하게 식별합니다. 다음 범위 중 하나 내에서 고유해야 합니다.

  • 도메인: 도메인 범위 별칭은 별칭 작성자의 도메인 내에 있는 모든 사용자에게 표시되며 도메인 관리자만 만들 수 있습니다. 도메인 범위 별칭은 강의에 클래스룸 외부의 식별자가 있을 때 자주 사용됩니다.

  • 프로젝트: 프로젝트 범위 별칭은 별칭을 만든 개발자 콘솔 프로젝트 ID를 사용하는 애플리케이션의 모든 요청에 표시되며 모든 프로젝트에서 만들 수 있습니다. 프로젝트 범위 별칭은 애플리케이션에 대체 식별자가 있을 때 자주 사용됩니다. 또한 랜덤 값을 사용하면 전송 실패 시 중복 과정을 피할 수 있습니다. 이전 요청이 성공한 경우 요청을 재시도하면 ALREADY_EXISTS을 반환하기 때문입니다.

JSON 표현
{
  "alias": string
}
필드
alias

string

별칭 문자열입니다. 문자열 형식은 원하는 별칭 범위를 나타냅니다.

  • d:<name>는 도메인 범위 별칭을 나타냅니다. 예: d:math_101
  • p:<name>는 프로젝트 범위 별칭을 나타냅니다. 예: p:abc123

이 필드의 최대 길이는 256자(영문 기준)입니다.

메서드

create

과정의 별칭을 만듭니다.

delete

강의의 별칭을 삭제합니다.

list

과정의 별칭 목록을 반환합니다.