Meet 부가기능 배포하기

Google Meet 부가기능은 Google Cloud 프로젝트의 일부로 생성 및 구성됩니다.

Google Cloud 프로젝트 만들기

Google Cloud 프로젝트를 생성하려면 Google Cloud 프로젝트 만들기를 참고하세요.

Google Workspace Marketplace SDK 및 Google Workspace Add-ons API 사용 설정

Meet 부가기능을 개발하려면 Google Workspace Marketplace SDK 및 Google Workspace Add-ons API가 필요합니다. 사용 설정하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔을 엽니다.
  2. 다른 프로젝트가 이미 열려 있는 경우 상단에서 앱 프로젝트의 프로젝트 이름을 선택하여 프로젝트를 전환합니다.
  3. 상단의 검색창에 Google Workspace Marketplace SDK를 입력하고 Enter 키를 누릅니다.
  4. Google Workspace Marketplace SDK 페이지를 열고 사용 설정을 클릭합니다.

  5. 이 단계를 반복하여 Google Workspace Add-ons API를 찾아 사용 설정합니다.

배포 만들기

Meet에서 부가기능을 사용하려면 배포와 부가기능 매니페스트 파일이 필요합니다.

  1. Google Cloud 콘솔을 엽니다.
  2. 다른 프로젝트가 이미 열려 있는 경우 상단에서 앱 프로젝트의 프로젝트 이름을 선택하여 프로젝트를 전환합니다.
  3. API 및 서비스를 클릭합니다.
  4. Google Workspace Marketplace SDK를 선택하여 세부정보 페이지를 봅니다.

배포 만들기

HTTP 배포를 만들거나 (권장) Google Apps Script를 사용하여 Google Cloud 콘솔에서 직접 배포를 만들 수 있습니다.

HTTP 배포

  1. HTTP 배포 탭을 클릭합니다.
  2. 새 배포 만들기를 클릭하고 부가기능의 배포 ID를 입력합니다.

    배포 ID는 부가기능 개발자가 부가기능 매니페스트가 포함된 배포를 식별하는 데 도움이 되는 임의의 문자열입니다. 배포 ID는 필수 항목이며 100자(영문 기준) 이하여야 합니다.

  3. 다음을 클릭합니다.

    JSON 형식의 부가기능 매니페스트 사양을 제출할 수 있는 측면 패널이 열립니다. 이를 DEPLOYMENT.JSON이라고도 합니다.

    부가기능 매니페스트 파일은 Google Meet 부가기능의 중앙 구성입니다. 다음 코드 샘플은 부가기능 매니페스트 파일에서 웹에 사용할 수 있는 Meet 필드를 보여줍니다.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUri": "SIDE_PANEL_URI",
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
            "logoUrl": "MEET_WEB_LOGO_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING
          }
        }
      }
    }
    

    다음을 바꿉니다.

    • NAME: 문자열입니다. Google Meet 부가기능의 이름입니다.
    • LOGO_URL: 문자열입니다. Google Workspace 부가기능 로고의 URL입니다. Google Workspace 제품 전반의 부가기능에 사용됩니다.
    • SIDE_PANEL_URI: 문자열입니다. 부가기능 앱의 진입점 URL입니다. 측면 패널 내 iframe에 표시됩니다. 이 URL의 출처ADD_ON_ORIGINS 필드에 지정된 출처의 일부여야 합니다.
    • ADD_ON_ORIGINS: 문자열 목록입니다. 부가기능이 호스팅되는 출처 목록입니다. 두 URL의 스키마, 호스트, 포트가 동일하면 두 URL의 출처가 동일합니다. 하위 출처도 허용되며 와일드 카드 하위 도메인도 허용됩니다. 자세한 내용은 부가기능 보안을 참고하세요.
    • DARK_MODE_LOGO_URL: 문자열입니다. 어두운 모드 전용 부가기능 로고의 URL입니다. 어두운 모드 로고를 제공하면 모든 Meet 테마에서 부가기능이 가장 잘 표시됩니다. 로고 디자인 가이드라인은 권장사항을 참고하세요.
    • MEET_WEB_LOGO_URL: 선택사항. 문자열. 부가기능 로고의 Meet용 URL입니다. 이 로고는 Meet 전체에서 사용됩니다. 없으면 공통 섹션의 logoUrl이 사용됩니다. 로고 디자인 가이드라인은 권장사항을 참고하세요.
    • SUPPORTS_SCREENSHARING: 선택사항. 부울. false로 설정하면 사용자는 부가기능을 사용하여 공동작업 부가기능 세션에서 어떤 일이 일어나고 있는지 확인해야 합니다. true로 설정하면 공동작업 부가기능 세션의 시작자가 부가기능 보기를 화면 공유할 수 있습니다.
  4. 제출을 클릭합니다.

    배포에 관한 자세한 내용은 배포 리소스 만들기를 참고하세요.

  5. 앱 구성 탭의 앱 통합에서 Google Workspace 부가기능을 선택합니다. 클라우드 배포 리소스를 사용하여 배포를 선택한 후 올바른 HTTP 배포를 선택합니다.

Google Apps Script

  1. 앱 구성 탭을 클릭합니다.

  2. 앱 통합에서 Google Workspace 부가기능을 선택합니다. Google Apps Script 배포 ID를 사용하여 배포를 선택하고 스크립트의 배포 ID를 입력합니다.

  3. 저장을 클릭합니다.

    Apps Script 프로젝트를 만드는 방법에 관한 자세한 내용은 Apps Script 문서를 참고하세요. Meet 부가기능은 Apps Script 프로젝트 매니페스트라고도 하는 appsscript.json 매니페스트 파일만 사용합니다. Apps Script 프로젝트의 매니페스트 파일에 addOnsmeet 섹션이 포함되어 있는지 확인합니다. addOnsmeet 섹션은 HTTP 배포 탭에 설명된 것과 동일한 구조를 따릅니다.

    다른 Google Workspace 부가기능과 달리 Meet 부가기능은 Apps Script로 완전히 빌드할 수 없습니다. 대신 측면 패널과 기본 스테이지를 만들어 전체 웹 앱을 빌드해야 합니다. 그런 다음 웹 앱의 측면 패널 URL을 appsscript.json 매니페스트 파일의 SIDE_PANEL_URI 아래에 지정해야 합니다.

Meet에서 부가기능 설치 및 테스트하기

Meet에서 부가기능을 테스트하려면 먼저 로그인한 사용자를 위해 부가기능을 설치해야 합니다.

HTTP 배포

  1. Google Cloud 콘솔에서 프로젝트의 Google Workspace Marketplace SDK로 이동합니다.
  2. HTTP 배포 탭을 클릭합니다.
  3. 작업 열에서 설치를 클릭합니다.

Google Apps Script

  1. Google Workspace 부가기능 문서에 따라 게시되지 않은 부가기능을 설치합니다.

이제 회의에서 부가기능을 사용할 수 있습니다. 사용해 보려면 meet.google.com에서 회의를 시작하세요. 이제 설치된 부가기능이 활동 패널에 표시됩니다.

로그인한 개별 사용자를 위해 부가기능을 설치하는 것 외에도 게시할 수도 있습니다. Google Workspace 부가기능을 게시하면 다른 사용자가 이를 찾아 설치하고 사용할 수 있습니다.