모든 개발자가 Google 클래스룸 API를 요청할 수 있지만 일부 Google 클래스룸 기능은 특정 사용자만 사용할 수 있습니다. 각 기능에는 특정 Google Workspace for Education 라이선스 유형을 보유하는 등 서로 다른 요구사항이 적용될 수 있습니다. 각 Google Workspace for Education 라이선스 수준의 기능에 관한 자세한 내용은 버전 비교 페이지를 참고하세요.
자격 요건이 있는 기능
다음 Classroom API 기능은 자격 요건을 충족하는 사용자만 사용할 수 있습니다.
사용자 기능 확인
Classroom API에 대한 요청은 개별 사용자를 대신하여 이루어집니다. 따라서 자격요건이 포함된 API 요청을 실행하기 전에 사용자에게 적절한 기능이 있는지 확인해야 합니다.
사용자에게 특정 기능이 있는지 확인하려면 checkUserCapability 메서드에 API 요청을 보냅니다. 사용할 클래스룸 기능에 적절한 Capability 유형을 포함합니다. 각 지형지물에 적절한 Capability를 지정합니다.
| 사용자가... | Capability |
|---|---|
| 요청하는 Google Cloud 프로젝트에서 소유한 클래스룸 부가기능에 액세스할 수 있습니다. | CREATE_ADD_ON_ATTACHMENT |
| 평가 기간 설정 수정 가능 | UPDATE_GRADING_PERIOD_SETTINGS |
| 기준표를 만들거나 수정할 수 있습니다. | CREATE_RUBRIC |
그런 다음 응답에서 allowed 필드를 확인합니다. allowed가 true이면 사용자가 선택한 Capability에 액세스할 수 있습니다. 그런 다음 사용자를 대신하여 Capability와 관련된 API 요청을 실행할 수 있습니다.