REST Resource: courses.aliases

리소스: CourseAlias

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

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

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

  • 프로젝트: 프로젝트 범위 별칭은 별칭을 생성한 Play Console 프로젝트 ID를 사용하는 애플리케이션의 모든 요청에 표시되며, 모든 프로젝트에서 생성할 수 있습니다. 프로젝트 범위 별칭은 애플리케이션에 대체 식별자가 있을 때 사용되는 경우가 많습니다. 또한 이전 요청이 성공한 경우 요청을 재시도하면 ALREADY_EXISTS가 반환되므로 전송 실패 시 코스가 중복되는 것을 피하기 위해 임의의 값을 사용할 수도 있습니다.

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

string

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

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

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

방법

create

수업의 별칭을 만듭니다.

delete

수업의 별칭을 삭제합니다.

list

수업의 별칭 목록을 반환합니다.