Google Workspace Marketplace의 앱 검토 절차 및 요구사항

• 앱과 통신하는 버튼은 설명에서 확인할 수 있습니다.
• 앱 이름은 A~Z (대문자) 또는 0~9로 시작합니다. 기호로 시작할 수 없습니다.

• 앱은 사용자가 채팅 메시지를 시작하거나 앱이 스페이스에 추가될 때마다 사용자에게 메시지를 보내지 않고 환영 메시지를 전송합니다. 시작 메시지는 '도움말' 명령어와 다릅니다. 자세한 내용은 Google Chat 앱의 홈페이지 빌드를 참고하세요.
• 앱은 '도움말' 명령어를 지원하며 사용자가 앱 사용을 시작할 수 있도록 지원합니다. 자세한 내용은 슬래시 명령어에 응답을 참고하세요.
• 스페이스 또는 직접적인 Chat에서 말을 받으면 앱이 항상 응답합니다.
• 메시지의 맞춤법, 대소문자, 구두점, 문법이 올바르며 악의적이거나 불쾌감을 주는 자료가 포함되어 있지 않습니다.
• 메시지는 Google 요구사항에 따라 텍스트 또는 카드에 명확하고 간결하며 일관된 형식을 사용합니다.
• 응답에 2초보다 오래 걸리는 경우 앱에서 지연을 설명하는 메시지를 보냅니다.
• 알림을 보내는 앱은 사용자가 알림을 사용 중지할 수 있도록 허용합니다.
• 사용자는 @멘션을 사용하여 앱을 스페이스에 추가할 수 있습니다.
• 사용자는 참여자 보기 메뉴를 사용하여 스페이스에서 앱을 삭제할 수 있습니다.
• 앱이 상호작용하는 데 필요한 모든 것을 사용자에게 나타냅니다.
• 앱에서 사용하는 카드 형식이 Google 요구사항을 충족합니다. 대화형 카드 만들기를 참고하세요.
• Chat 메뉴의 앱 찾기 옵션에서 앱을 사용할 수 있습니다.
• 앱이 상호작용하는 외부 URL이 스테이징 또는 개발 환경에 속하지 않습니다.
• @멘션은 스페이스에서 앱으로 보내는 모든 메시지에 필요합니다. 앱이 응답해야 한다는 것을 알 수 있는 유일한 방법입니다.
• Chat 앱이 서드 파티 도메인의 링크를 미리 보는 경우 다음 안내를 따르세요.
  • 링크 미리보기는 사용자의 메시지와 관련된 보충 정보를 제공합니다. 예를 들어 판매 거래 링크를 미리 보려면 계정, 금액, 단계와 같은 정보가 추가됩니다.
  • 개발자가 미리 본 도메인과 제휴되어 있습니다.

  자세한 내용은 링크 미리보기를 참고하세요.

• (권장) Workspace 관리자가 조직의 사용자를 대신하여 앱을 설치할 수 있도록 하려면 앱에서 채팅 메시지를 수신하고 보낼 수 있어야 합니다.

• 앱에 알아보기 쉽고 선명한 아바타가 있습니다.

• 앱이 Chrome 브라우저 확장 프로그램을 사용하여 Drive HTML을 직접 조작하여 기능을 제공하지 않습니다.
• 앱에서 민감하거나 제한된 범위를 사용하는 경우 OAuth 인증을 받아야 합니다. 인증을 위해 어떻게 제출하나요?를 참고하세요.
• 앱에서 제한된 범위를 사용하는 경우 보안 평가도 받아야 합니다. 보안 평가가 필요한 이유를 참고하세요.

• 앱이 Drive에 파일을 저장하는 경우 사용자가 폴더를 선택하거나 앱별 폴더를 만들고 재사용할 수 있습니다. 구성 데이터는 앱 데이터 폴더에 저장할 수 있습니다. 앱은 사용자의 내 드라이브 폴더에 파일을 덤프하지 않습니다.
• 앱은 문서화된 앱 기능과 연결된 파일만 Drive에 저장합니다.

• 예상되는 작업과 필수 작업이 부가기능에 포함되어 있으며 워크플로를 완료하는 데 필요한 모든 도구를 제공합니다. 예:
  • 부가기능이 전체 문서에 스타일을 적용하는 경우 선택한 텍스트에만 스타일을 적용하는 옵션이 제공됩니다.
  • 부가기능이 스프레드시트 데이터를 웹 서비스 피드에 업로드하는 경우 쉽게 이동할 수 있도록 해당 피드 링크가 있습니다.
  • 부가기능에 사용자가 계정을 가지고 있어야 하는 경우 사용자가 계정이 없는 경우 계정을 쉽게 만들 수 있는 링크나 정보를 제공합니다.
• 부가기능의 부가기능 탭에 메뉴 항목이 있습니다.
• 부가기능이 맞춤 함수일 뿐이라도 적절한 문서가 포함되어 있습니다.
• 부가기능이 onInstall() 및 onOpen()를 올바르게 사용하여 메뉴를 채웁니다. 메뉴 항목은 부가기능이 처음 설치될 때와 다른 파일이 열릴 때 채워집니다. 편집자 부가기능 승인을 참고하세요.
• 승인 모드가 올바르게 설정되었습니다. 승인 모드를 참고하세요.
• 부가기능은 Apps Script의 V8 런타임에서 구현해야 합니다. 자세한 내용은 V8 런타임 개요를 참고하세요.

• 이 부가기능은 제품과 사용 방법을 기본적으로 이해하는 데 필요한 모든 정보를 제공합니다.
• 라이브러리가 부가기능의 성능 저하를 일으킬 수 있으므로 부가기능 코드에서 라이브러리를 과도하게 사용하지 않습니다.
• 가능한 경우 오류를 방지하고 그렇지 않은 경우 적절하게 관리합니다.
  • 오류 메시지는 JavaScript 알림이나 기본 빨간색 막대가 아닌 대화상자 창에 표시됩니다. 문제를 알리고 사용자가 문제를 해결하기 위해 취해야 할 조치를 간단한 언어로 설명합니다.
  • 가능한 경우 사용자가 잘못하고 있는 경우 문제를 해결하는 버튼이 표시됩니다.
  • 자세한 내용은 부가기능 스타일 가이드를 참고하세요.
• 외부 페이지 링크가 새 창에서 열리고 올바릅니다.
• 부가기능이 직관적이고 잘 설계되었습니다. 따라서 다음과 같은 상황이 발생할 수 있습니다.
  • 해야 할 일과 방법이 항상 명확합니다.
  • 액세스하기 쉽고 이해하기 간단한 부가기능 기술 용어 및 전문 용어는 피합니다.
  • 워크플로는 최대한 명확하고 원활합니다.
  • 사용자와 콘텐츠가 최대한 안전합니다.
• 이 부가기능은 편집기 부가기능용 UI 스타일 가이드를 따르며 편집기 부가기능용 CSS 패키지를 사용합니다.
• 이 부가기능은 디스플레이당 하나의 파란색 기본 작업만 사용합니다.
• 부가기능은 한 번에 하나의 대화상자를 표시합니다. 중복되지 않고 한 번에 여러 대화상자가 열리지 않습니다.
• 부가기능의 UI가 할당된 공간에 잘 맞습니다.
  • 텍스트와 라벨이 '...'로 잘리지 않음
  • 사용자가 세로 스크롤을 많이 하지 않아도 됩니다.
  • 콘텐츠 너비가 300p를 초과하지 않으므로 가로 스크롤바가 없습니다.
• 부가기능에 확인이 필요하거나 모든 민감한 작업에 경고가 표시됩니다. 예를 들어 부가기능이 스프레드시트의 모든 콘텐츠를 덮어쓸 때는 사용자에게 경고가 표시되고 작업이 실행되기 전에 확인을 받습니다.

  디자인을 변경하여 이 요구사항을 피할 수 있습니다. 예를 들어 데이터를 가져오는 Google Sheets 부가기능은 기존 콘텐츠를 덮어쓸 위험이 있습니다. 데이터 시트를 기본 작업으로 만들어 위험을 제거할 수 있습니다.

• 작업이 로드되는 동안 사용자는 작업을 여러 번 트리거할 수 없습니다. 예를 들어 작업이 로드되는 동안 버튼이 꺼지거나 숨겨집니다.

Calendar 부가기능

• 부가기능이 calendar.name 또는 common.name를 사용하는 경우 매니페스트의 이름은 앱 등록정보에 제공된 이름과 동일합니다.
• 부가기능에서 calendar.conferenceSolution를 사용하는 경우 회의 솔루션 이름에 'Google Calendar'가 포함되지 않습니다.
• (권장) 부가기능이 calendar.conferenceSolution를 사용하는 경우 회의 솔루션 이름은 30자(영문 기준)를 초과하지 않습니다.

• 부가기능이 원하는 기능에 올바른 위젯 (또는 Meet 부가기능의 iframe UI)을 사용합니다. 예를 들어 스위치를 사용하여 불리언 값을 선택합니다.

Calendar 부가기능

• 보조 캘린더 및 위임은 지원되며, 지원되지 않는 경우 정상적으로 관리됩니다. 예를 들어 사용자가 일정을 만들 때 수정 액세스 권한이 있는 다른 캘린더를 선택해도 회의 생성에 실패하지 않습니다.
• 반복 일정이 올바르게 작동합니다.
• 부가기능이 calendar.conferenceSolution를 사용하는 경우 하나 이상의 회의 솔루션이 제공됩니다.
• 부가기능에서 회의 솔루션을 제공하는 경우 적절한 회의 데이터 필드가 사용됩니다. 예를 들어 화상 회의 링크, 전화번호, SIP 링크, 액세스 코드, 기타 지원되는 속성은 구조화된 데이터 필드를 사용하며 메모 필드에 제공되지 않습니다.
• 부가기능이 회의 솔루션을 제공하는 경우 회의 세부정보만 수정하고 다른 일정 입력란은 수정하지 않습니다.
• 부가기능에서 회의 솔루션을 제공하는 경우 회의를 만드는 데 5초 미만이 소요됩니다.

Gmail 부가기능

부가기능이 UrlFetchApp 또는 OpenLinkUrl를 사용하는 경우:

• URL이 유효합니다.
• URL이 HTTP가 아닌 HTTPS를 사용합니다.
• 전체 도메인이 지정됩니다.
• 경로가 비어 있지 않습니다. 예를 들어 https://altostrat/는 괜찮지만 https://altostrat은 그렇지 않습니다.
• UrlFetchApp에는 와일드 카드를 사용할 수 없습니다.

Meet 부가기능

• 서드 파티 쿠키가 사용 중지된 경우에도 부가기능 로그인 및 사용자 여정이 작동해야 합니다.
• 부가기능은 회의 진행 또는 회의 참여와 관련된 기능을 제공해야 합니다.
• 부가기능은 브라우저를 새로고침하는 등 사용자가 회의에서 나가도록 하는 어떠한 작업도 해서는 안 됩니다.
• 멀티플레이어 환경을 사용하는 경우 부가기능은 권한이 사전에 설정되지 않은 경우에도 모든 참여자가 콘텐츠에 공동작업할 수 있도록 허용해야 합니다. 공동작업 부가기능 세션 중에 권한을 조정할 수 있어야 합니다.
• 부가기능은 시작 활동 흐름 취소를 처리하고 사용자가 앱에서 활동 시작을 다시 시작할 수 있도록 허용해야 합니다.
• 부가기능은 활동 환경의 로그인 및 설정을 위한 측면 패널을 제공해야 합니다.
• 부가기능은 봇을 초대하는 기능을 제공하거나 회의에 봇이 있는 상태를 활용해서는 안 됩니다.

• 부가기능에 홈페이지가 있습니다. Google Workspace 부가기능이 전환된 Gmail 부가기능인 경우 기본 홈페이지가 적용됩니다.
• 부가기능 카드 (또는 Meet 부가기능의 iframe UI)가 제대로 작동합니다. 예를 들어 중복된 항목이 없으므로 뒤로, 새로고침, 업데이트 버튼이 적절하게 작동합니다.
• 사용자가 부가기능을 승인하면 맞춤 홈페이지 카드 (Meet 부가기능의 웹페이지)가 표시되어 로그인 버튼(필요한 경우), 로고, 부가기능에 관한 간단한 설명을 통해 사용자를 맞이합니다.
  • 로그인 버튼이 트리거되면 Google Workspace 외부에서 작동하는 서드 파티 서비스가 있음을 명확하게 나타내는 서드 파티 공급업체의 맞춤설정된 로그인 페이지가 표시됩니다.
• 추가 기능의 UI가 할당된 공간에 잘 맞습니다.
  • 텍스트와 라벨이 '...'로 잘리지 않습니다.
  • 사용자가 세로 스크롤을 많이 할 필요가 없습니다.
  • 콘텐츠 너비가 300p를 초과하지 않으므로 가로 스크롤바가 없습니다.
• 라이브러리가 부가기능의 성능을 떨어뜨릴 수 있으므로 부가기능의 코드에서 라이브러리를 과도하게 사용하지 않습니다.

Calendar 부가기능

• 부가기능이 회의 솔루션을 제공하는 경우 생성된 회의가 유효하며 서드 파티 회의 웹사이트에 올바르게 표시됩니다.

Docs 부가기능

부가기능이 서드 파티 도메인의 링크를 미리 보는 경우 (스마트 칩):

• 링크 미리보기는 사용자에게 관련성 높은 보조 정보를 제공합니다. 예를 들어 판매 거래 링크를 미리 보려면 계정, 금액, 단계와 같은 정보가 추가됩니다.
• 개발자가 미리 본 도메인과 제휴되어 있습니다.

자세한 내용은 스마트 칩을 사용한 링크 미리보기를 참고하세요.

Drive 부가기능

• 앱이 Drive에 파일을 저장하는 경우 사용자가 폴더를 선택하거나 앱별 폴더를 만들고 재사용할 수 있습니다. 구성 데이터는 앱 데이터 폴더에 저장할 수 있습니다. 앱이 사용자의 내 드라이브 폴더에 파일을 덤프하지 않습니다.
• 부가기능은 부가기능의 문서화된 기능과 연결된 파일만 드라이브에 저장합니다.

Gmail 부가기능

• 부가기능에서 정당한 이유 없이 Chrome 브라우저 확장 프로그램을 언급하거나 연결하지 않습니다.
• 추가 작업 메뉴 more_vert에는 올바르게 작동하는 범용 작업이 포함되어 있습니다. 예: 로그아웃, 정보, 지원 등

Meet 부가기능

• 부가기능에 라이선스 또는 구독이 필요한 경우: 사용자에게 라이선스가 없는 경우 사용자 친화적인 메시지가 표시되어야 합니다.
• 사용자가 라이선스 문제로 인해 부가기능을 사용할 수 없는 경우 오류 메시지에 부가기능을 사용할 수 없는 이유를 명확하게 명시하고 사용자가 상황을 해결할 수 있는 조치를 제안해야 합니다.
• 부가기능의 Google Workspace Marketplace 등록정보에는 부가기능을 사용하기 위해 필요할 수 있는 라이선스 및 구독 요구사항에 관한 세부정보를 지정해야 합니다. 부가기능에 유료 등급이 있는 경우 마켓플레이스 등록정보에 가격 또는 영업사원에게 문의하는 방법에 관한 자세한 정보를 제공하는 웹페이지 링크를 제공해야 합니다.
• 사용자가 아직 로그인하지 않은 경우 부가기능은 Google 원탭 표시에 있는 원탭 로그인 메시지와 인증에 있는 'Google 계정으로 로그인' 대체 옵션을 표시해야 합니다. 'Google 계정으로 로그인' 메커니즘 외에도 다른 로그인 옵션이 제공될 수 있습니다.
• 부가기능에는 콘텐츠를 다양한 크기에 맞게 조정할 수 있는 반응형 디자인이 있어야 합니다.
• 서드 파티 쿠키가 사용 중지된 경우에도 부가기능 사용자 여정이 작동해야 합니다.
• 부가기능에 iframe 내에서 가로 스크롤이 없어야 합니다.
• 부가기능에서 메인 스테이지를 사용하려면 부가기능이 멀티플레이어 환경용으로 설계되어야 하며 여러 참여자가 동시에 콘텐츠를 조작할 수 있어야 합니다. 싱글 플레이어 환경의 경우 개발자가 측면 패널을 사용해야 합니다.
• (권장) 로그인한 사용자를 부가기능에 표시해야 합니다.
• (권장) 현지화 선택: 언어는 가능한 경우 브라우저에서 설정한 현지 환경설정을 기반으로 해야 합니다.
• (권장) 최근에 액세스한 콘텐츠가 표시되는 콘텐츠 탐색 인터페이스를 통해 콘텐츠를 선택해야 합니다.
• (권장) 측면 패널이 더 이상 필요하지 않으면 부가기능은 기본 스테이지로 실행된 후 측면 패널을 닫아야 합니다.

Calendar 부가기능

• 회의 솔루션의 로고는 공개 URL입니다. 회의 솔루션 로고 제공을 참고하세요.
• 부가기능에서 calendar.conferenceSolution를 사용하는 경우 회의 솔루션의 로고는 calendar.logoUrl 요구사항을 따릅니다. Calendar 매니페스트 리소스를 참고하세요.
• 부가기능이 calendar.logoUrl 또는 common.logoUrl를 사용하는 경우 로고는 앱 등록정보에 제공된 아이콘과 동일합니다.
• 부가기능에서 calendar.logoUrl 또는 common.logoUrl를 사용하는 경우 로고의 URL은 다음과 같이 시작됩니다. https://lh3.googleusercontent.com/

Meet 부가기능

• 부가기능의 브랜드 로고는 Meet 측면 패널에서 식별할 수 있는 크기와 스타일이어야 합니다.
• 추가 항목 manifest에 적절한 어두운 모드 로고 URL을 지정해야 합니다.

Drive 부가기능

• (권장) 제한된 메타데이터를 수신하려면 부가기능에 drive.addons.metadata.readonly 범위가 포함되어야 합니다.

• 범용 탐색 URL은 웹 앱을 가리킵니다. 기능이 없는 간단한 웹페이지는 웹 앱으로 간주되지 않습니다.