사용자 자격요건

모든 개발자가 Google 클래스룸 API를 요청할 수 있지만 일부 Google 클래스룸 기능은 특정 사용자만 사용할 수 있습니다. 각 기능에는 특정 Google Workspace for Education 라이선스 유형을 보유하는 등 서로 다른 요구사항이 적용될 수 있습니다. 각 Google Workspace for Education 라이선스 수준의 기능에 관한 자세한 내용은 버전 비교 페이지를 참고하세요.

핵심 용어: 자격요건을 충족하는 사용자는 기능 요구사항을 충족하는 경우 특정 클래스룸 기능을 사용할 수 있는 기능이 있습니다.

핵심사항: 기능은 사용자별로 별도로 결정되며 시간이 지남에 따라 변경될 수 있습니다. Classroom API의 일부 기능에 대한 기능 자격요건은 Google 클래스룸 앱의 해당 기능과 다를 수 있습니다. 예를 들어 API로 평가 기준을 만들거나 수정하거나 삭제할 때는 특정 라이선스 요구사항이 적용됩니다.

자격 요건이 있는 기능

다음 Classroom API 기능은 자격 요건을 충족하는 사용자만 사용할 수 있습니다.

• 클래스룸 부가기능 첨부파일 만들기 및 수정
• 평가 기간 설정을 수정합니다.
• 기준 생성, 수정, 삭제

사용자 기능 확인

Classroom API에 대한 요청은 개별 사용자를 대신하여 이루어집니다. 따라서 자격요건이 포함된 API 요청을 실행하기 전에 사용자에게 적절한 기능이 있는지 확인해야 합니다.

핵심사항: 사용자가 액세스할 수 있는 클래스룸 기능에 맞게 제품의 모양이나 동작을 조정할 수 있도록 사용자 기능을 사전에 확인해 보세요.

사용자에게 특정 기능이 있는지 확인하려면 checkUserCapability 메서드에 API 요청을 보냅니다. 사용할 클래스룸 기능에 적절한 Capability 유형을 포함합니다. 각 기능에 적절한 Capability를 지정합니다.

사용자가...	Capability
요청하는 데 사용된 OAuth 클라이언트 ID의 Google Cloud 프로젝트와 연결된 클래스룸 부가기능 첨부파일을 만들거나 수정할 수 있습니다.	CREATE_ADD_ON_ATTACHMENT
평가 기간 설정을 수정할 수 있습니다.	UPDATE_GRADING_PERIOD_SETTINGS
기준표를 만들고, 수정하거나 삭제할 수 있습니다.	CREATE_RUBRIC

그런 다음 응답에서 allowed 필드를 확인합니다. allowed가 true이면 사용자가 선택한 Capability에 액세스할 수 있습니다. 그런 다음 사용자를 대신하여 Capability와 관련된 API 요청을 실행할 수 있습니다.

중요: 사용자가 자격 요건을 충족하더라도 자격 요건에 종속된 API 요청이 실패할 수 있습니다. 자격요건은 특정 요청이 승인된다는 의미가 아니라 사용자가 클래스룸 기능을 사용할 수 있다는 의미입니다.