이 페이지는 Cloud Translation API를 통해 번역되었습니다.

권장사항

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 Cloud 프로젝트 만들기

Google Meet 부가기능이 Google Workspace Marketplace에 게시되면 Meet 사용자는 Google Meet 부가기능의 새로운 배포를 즉시 사용할 수 있습니다. 사용자는 캐시를 비우거나 캐시가 만료되는 즉시 이러한 업데이트를 확인할 수 있습니다. 따라서 변경사항을 철저히 테스트할 때까지 프로덕션 사이트에 변경사항을 푸시하지 않는 것이 좋습니다.

프로덕션에 바로 배포하지 않으려면 조직에 비공개로 게시되는 별도의 Google Cloud 프로젝트를 만드는 것이 좋습니다. 이 Cloud 프로젝트는 Meet 부가기능의 스테이징 환경과 개발 환경을 모두 호스팅합니다. 이 Cloud 프로젝트의 액세스 권한은 부가기능 개발을 직접 담당하는 소규모 팀으로 제한해야 합니다.

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

스테이징: 조직의 모든 사용자가 테스트에 참여할 수 있도록 스테이징 버전을 비공개로 게시합니다.
개발: 작업 열에서 설치를 클릭하여 Meet 부가기능 개발 버전을 내 계정에만 설치합니다.

테스트 작성

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

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

사용자 환경 권장사항

다음 권장사항을 따르면 Meet 부가기능을 더 직관적이고 세련되게 만들 수 있습니다.

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

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

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

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

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

로고 디자인 가이드라인

Meet 전용 로고를 디자인할 때는 지금과 앞으로도 최상의 상태를 유지할 수 있도록 다음 가이드라인을 따르세요.

크기가 256x256픽셀인 PNG 파일 형식을 사용하세요.

투명성을 사용하세요.

Meet 부가기능용 개발자 도구를 사용하여 어두운 모드 로고가 어두운 모드에서 잘 표시되는지 확인하세요.

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

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

Meet 부가기능 오류 문제 해결하기