클래스룸 부가기능에서 Google SSO를 구현하는 방법에 관한 안내는 원활한 로그인 페이지를 참고하세요. 원활한 로그인 가이드에서는 부가기능이 로그인 권장사항을 따르는지 확인하는 데 사용할 수 있는 테스트 계획도 참고합니다.
로그인 흐름
사용자의 로그인 마찰을 줄이기 위해 Google 클래스룸은 iframe이 열릴 때 login_hint 쿼리 매개변수를 제공합니다. login_hint는 사용자의 고유한 Google ID이며, 사용자가 부가기능에 처음 로그인한 후에 제공됩니다. 이 매개변수는 Google 클래스룸에 로그인한 사용자에 관한 컨텍스트를 제공합니다. 이러한 쿼리 매개변수에 대한 자세한 내용은 로그인 매개변수 가이드 페이지를 참고하세요.
현재 Google 클래스룸 사용자의 login_hint 쿼리 매개변수가 부가기능의 로그인한 사용자와 일치하지 않으면 Google 로그인 대화상자를 표시해야 합니다. 버튼은 Google 브랜드 가이드라인을 준수해야 합니다. 사용자가 이미 로그인한 경우 다시 로그인하라는 메시지가 표시되지 않아야 합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-29(UTC)"],[],[],null,[]]
그림 1. 사용자가 처음 부가기능을 실행할 때의 로그인 흐름