권장사항

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 부가기능의 스테이징 및 개발 환경을 모두 호스팅합니다. 이 Cloud 프로젝트에 대한 액세스는 부가기능 개발에 직접 참여하는 소규모 팀으로 제한해야 합니다.

부가기능의 대체 환경을 만들려면 먼저 부가기능이 포함된 웹 애플리케이션의 대체 환경을 소유한 도메인에서 호스팅해야 합니다. 그런 다음, 스테이징 Google Cloud 프로젝트에 배포를 추가하여 Meet 부가기능의 대체 환경을 만들 수 있습니다. 이러한 새 배포에는 웹 애플리케이션의 대체 환경을 가리키는 매니페스트가 있어야 합니다. 그런 다음 각 부가기능 환경을 다음과 같이 설치하는 것이 좋습니다.

테스트 작성

개발 환경에 Meet 부가기능을 배포하기 전에 단위 테스트를 작성하는 것이 좋습니다. 단위 테스트에는 다음이 포함되어야 합니다.

  • Meet 부가기능 SDK를 모의 처리한 다음 Meet 부가기능이 SDK 함수를 예상대로 호출하는지 확인합니다.
  • 선호하는 웹 테스트 프레임워크를 사용하여 부가기능의 모든 비 SDK 관련 기능을 단위 테스트합니다.

사용자 환경 권장사항

다음 권장사항은 Meet 부가기능을 더 직관적이고 세련되게 만드는 데 도움이 됩니다.

측면 패널에서 모든 시작 상태 관리

측면 패널에서 실행된 사용자 작업을 기반으로 부가기능을 설정하는 것이 좋습니다. 이 작업은 활동 시작 상태를 JavaScript 에서 설정하여 실행됩니다. ActivityStartingState 로 이동하는 모든 데이터는 측면 패널 내에서 부가기능의 이니시에이터 (일반적으로 회의 주최자)가 설정해야 합니다. 측면 패널의 첫 번째 뷰를 부가기능 설정을 제어하는 양식으로 생각할 수 있습니다.

사용하지 않을 때 측면 패널 닫기

`startActivity()` startActivity() 메서드를 호출하여 활동을 시작한 후에는 Google Meet 부가기능의 사용자 환경에 필수적인 경우에만 측면 패널을 열어 두어야 합니다. 기본 스테이지 가 열리면 unloadSidePanel() 메서드를 호출하여 측면 패널을 닫을 수 있습니다.

화면 공유를 통해 Meet 부가기능 홍보

Meet 부가기능은 화면 공유보다 다양한 환경을 제공합니다. 하지만 많은 사용자가 Meet의 화면 공유 기능을 사용하는 데 익숙합니다. 사용자가 Meet 부가기능을 호스팅하는 웹사이트를 표시하는 탭을 공유하는 경우 Meet은 모든 통화 참여자에게 해당 Meet 부가기능을 설치하거나 사용하라는 배너를 표시하도록 구성할 수 있습니다. 자세한 내용은 화면 공유를 통한 부가기능 홍보를 참고하세요.

로고 디자인 가이드라인

Meet 전용 로고를 디자인할 때 현재와 미래에 최상의 모습으로 보이도록 하려면 다음 가이드라인을 따르세요.

PNG 파일 형식을 사용하고 크기를 256x256픽셀로 지정합니다.

투명도를 사용합니다.

Meet 부가기능의 개발자 도구를 사용하여 어두운 모드에서 어두운 모드 로고가 보기 좋게 표시되는지 확인합니다.

Web Accessibility In Mind (WebAIM)의 Contrast Checker와 같은 대비 검사기를 사용하여 로고 (및 기타 그래픽 저작물)가 고대비 모드에서 보기 좋게 표시되는지 확인합니다.

특정 앱 통합의 그래픽 요구사항을 준수합니다.

이미지에 패딩을 포함하지 마세요. 대신 이미지를 파일의 경계까지 확장합니다.