Google Meet 부가기능 디자인에 관한 다음 가이드를 따라 사용자의 전반적인 환경을 개선하세요.
승인 권장사항
인증 또는 승인이 필요한 Google Meet 부가기능에는 다음 권장사항을 사용하는 것이 좋습니다.
Google 로그인 사용
Google Workspace 부가기능 사용자는 회의에 참여하기 전에 이미 Google에 로그인한 경우가 많습니다. 따라서 Google 원탭을 옵션으로 제공하면 사용자가 로그인 흐름을 진행할 때 클릭 수를 줄일 수 있습니다. 자세한 내용은 부가기능의 로그인 방법 관리를 참고하세요.
새 창에서 서드 파티 로그인 페이지 열기
Google 로그인 외에도 애플리케이션에서 추가 로그인 메커니즘을 제공할 수 있습니다. 이 경우 새 탭에서 로그인 페이지를 여는 대신 대화상자 창을 사용하세요. 이렇게 하면 사용자가 Meet 통화를 계속 보고 다시 돌아갈 수 있으며 전체 클릭 수가 줄어듭니다.
Google API의 범위를 올바르게 요청
Meet 부가기능이 Google API를 호출하는 경우 부가기능에 필요한 OAuth 범위의 전체 목록을 제공해야 합니다. 이 작업은 Google Workspace Marketplace 앱 구성 페이지에서 실행됩니다. 이러한 범위를 추가하면 사용자가 Meet 부가기능을 설치할 때 앱이 액세스할 수 있는 데이터의 종류를 알려주는 메시지가 표시됩니다.
애드온을 게시하기 전에 OAuth 동의 화면도 설정해야 합니다. 이를 위해서는 Google Workspace Marketplace 앱 구성에서 정확히 동일한 승인 범위를 추가해야 합니다. OAuth 동의 화면을 구성하려면 범위가 요청될 때 표시되는 브랜드 정보, 개인정보처리방침, 서비스 약관도 설정해야 합니다. 이 모든 정보를 공개적으로 게시하려면 인증을 위해 제출해야 합니다.
Google Workspace API를 호출하는 코드를 작성할 때는 JavaScript 빠른 시작을 따르는 것이 가장 쉽게 시작하는 방법입니다. 이 접근 방식은 Google 로그인을 사용하고 대화상자 창을 사용하는 권장사항을 준수합니다. JavaScript에서 토큰 클라이언트를 초기화하려면 런타임에 애플리케이션이 실제로 사용하는 범위를 별도로 요청해야 합니다. 최상의 사용자 환경을 위해 요청된 범위는 Google Workspace Marketplace 앱 구성 페이지의 범위와 일치해야 합니다. 이 중복은 사용자가 범위를 취소한 경우를 처리하기 위한 대체를 제공합니다.
유지보수 권장사항
다음 권장사항은 유지관리 가능한 웹 애플리케이션을 작성하기 위한 것이지만 Meet 부가기능을 작성할 때는 특히 중요합니다.
최신 버전의 Google Meet 부가기능 SDK 사용
Meet 부가기능 SDK는 정기적으로 업데이트됩니다. SDK는 의미론적 버전 관리를 준수합니다. 최신 버전을 확인하려면 다음 단계를 따르세요.
- gstatic 사용 시: 최신 SDK 버전은 SDK 사용 안내에 있는 gstatic URL 내에 포함되어 있습니다.
- npm 사용 시: Meet 부가기능을 호스팅하는 웹사이트의
package.json이 포함된 디렉터리 내에서npm update @googleworkspace/meet-add-ons을 실행합니다.
스테이징 Google Cloud 프로젝트 만들기
Google Meet 부가기능이 Google Workspace Marketplace에 게시되면 Google Meet 부가기능의 새로운 배포가 Meet 사용자에게 즉시 제공됩니다. 사용자는 캐시를 비우거나 캐시가 만료되면 이러한 업데이트를 확인할 수 있습니다. 따라서 변경사항을 철저히 테스트할 때까지 프로덕션 사이트에 변경사항을 푸시하지 않는 것이 좋습니다.
프로덕션에 바로 배포하지 않으려면 조직에 비공개로 게시되는 별도의 Google Cloud 프로젝트를 만드는 것이 좋습니다. 이 Cloud 프로젝트는 Meet 부가기능의 스테이징 환경과 개발 환경을 모두 호스팅합니다. 이 클라우드 프로젝트에 대한 액세스는 부가기능 개발을 직접 담당하는 소규모 팀으로 제한해야 합니다.
부가기능의 대체 환경을 만들려면 먼저 부가기능이 포함된 웹 애플리케이션의 대체 환경을 소유한 도메인에 호스팅해야 합니다. 그런 다음 스테이징 Google Cloud 프로젝트에 배포를 추가하여 Meet 부가기능의 대체 환경을 만들 수 있습니다. 이러한 새 배포에는 웹 애플리케이션의 대체 환경을 가리키는 매니페스트가 있어야 합니다. 그런 다음 각 부가기능 환경을 다음과 같이 설치하는 것이 좋습니다.
- 스테이징: 조직의 모든 사용자가 테스트를 지원할 수 있도록 스테이징 버전을 비공개로 게시합니다.
- 개발: 작업 열에서 설치를 클릭하여 Meet 부가기능 개발 버전을 내 계정에만 설치합니다.
테스트 작성
개발 환경에 Meet 부가기능을 배포하기 전에 단위 테스트를 작성하는 것이 좋습니다. 단위 테스트에는 다음이 포함되어야 합니다.
- Meet 부가기능 SDK를 모의로 처리한 다음 Meet 부가기능이 예상대로 SDK 함수를 호출하는지 확인합니다.
- 선호하는 웹 테스트 프레임워크를 사용하여 부가기능의 모든 비 SDK 관련 기능을 단위 테스트합니다.
사용자 환경 권장사항
다음 권장사항은 Meet 부가기능을 더 직관적이고 세련되게 만드는 데 도움이 됩니다.
측면 패널에서 모든 시작 상태 관리
측면 패널에서 취한 사용자 작업을 기반으로 부가기능을 설정하는 것이 좋습니다.
이는 JavaScript에서 활동 시작 상태를 설정하여 실행됩니다. ActivityStartingState에 입력되는 모든 데이터는 부가기능의 이니시에이터 (일반적으로 회의 호스트)가 측면 패널 내에서 설정해야 합니다. 측면 패널의 첫 번째 뷰는 부가기능의 설정을 제어하는 양식으로 생각하면 됩니다.
사용하지 않을 때 측면 패널 닫기
startActivity() 메서드를 호출하여 활동을 시작한 후에는 Google Meet 부가기능의 사용자 환경에 필수적인 부분인 경우에만 측면 패널을 열어 두어야 합니다. 기본 스테이지가 열리면 unloadSidePanel() 메서드를 호출하여 측면 패널을 닫을 수 있습니다.
화면 공유를 통해 Meet 부가기능 홍보하기
Meet 부가기능은 화면 공유보다 풍부한 환경을 제공합니다. 하지만 많은 사용자가 Meet의 화면 공유 기능을 사용하는 데 익숙합니다. 사용자가 Meet 부가기능을 호스팅하는 웹사이트를 표시하는 탭을 공유하는 경우 모든 통화 참여자에게 해당 Meet 부가기능을 설치하거나 사용하라는 배너를 표시하도록 Meet을 구성할 수 있습니다. 자세한 내용은 화면 공유를 통해 부가기능 홍보하기를 참고하세요.
로고 디자인 가이드라인
Meet 전용 로고를 디자인할 때는 현재와 미래에 최상의 상태로 표시되도록 다음 가이드라인을 따르세요.
PNG 파일 형식을 사용하고 크기는 256px x 256px로 지정합니다.
투명도를 사용하세요.
Meet 부가기능용 개발자 도구를 사용하여 어두운 모드에서 어두운 모드 로고가 보기 좋게 표시되는지 확인하세요.
Web Accessibility In Mind (WebAIM)의 대비 검사기와 같은 대비 검사기를 사용하여 로고 (및 기타 그래픽 애셋)가 고대비 모드에서 보기 좋게 표시되는지 확인하세요.
특정 앱 통합을 위한 그래픽 요구사항을 준수하세요.
이미지에 패딩을 포함하지 마세요. 대신 이미지 파일을 파일의 경계까지 확장하세요.