연결된 앱 디자인 가이드라인

Gemini 앱, Google 검색과 같은 Google 제품 전반에서 연결된 앱을 설계하기 위한 가이드라인입니다.

개요

MCP 연결 앱을 사용하면 사용자가 해당 Google 제품에서 대규모 언어 모델(LLM)을 연결하여 앱의 데이터를 읽고 쓸 수 있습니다. 앱이 대화 컨텍스트를 공유하므로 사용자는 탭이나 앱을 전환하지 않고도 작업을 쉽게 완료할 수 있습니다. 이 가이드라인을 검토하여 연결된 앱이 관련 Google 제품에서 게시 승인을 받았는지 확인하세요.

연결된 앱 만들기

연결된 앱을 사용해야 하는 경우

다음 시나리오에 맞는 연결된 앱을 빌드합니다.

  • 주문, 예약, 일정 확정과 같이 시작과 끝이 명확한 작업입니다.
  • 사용자가 즉시 적용할 수 있는 활용 가능한 정보입니다.
  • 데이터 분석, 문서 검토, 프로젝트 조정과 같은 자연스러운 대화형 워크플로
  • AI가 수행할 수 있는 작업을 의미 있게 확장하는 핵심 기능입니다.

도구는 사용자가 AI의 도움을 받아 예약이나 문서 작성과 같은 작업을 완료하는 데 도움이 되어야 합니다. 파운데이션 모델이 프로세스를 간소화할 수 있는 복잡한 작업에 집중합니다.

피해야 할 사항

연결된 앱을 설계할 때는 다음 패턴을 피하세요.

  • 드롭다운, 컨텍스트 메뉴, 팝오버 패널: 이러한 요소는 컨테이너 경계에 의해 잘리거나 호스트 표시 경로 UI와 충돌합니다.
  • 중첩 스크롤: 스크롤 컨테이너 내에서 스크롤하지 않습니다.
  • 다중 레이어 뷰: 탐색경로 또는 드릴인 인터페이스를 사용하지 마세요.
  • 긴 프로세스: 표시 모드의 범위를 초과하는 흐름은 피하세요.
  • 독립형 웹 앱: 전체 웹 앱을 복제하지 마세요.
  • 기대에 미치지 못하는 결과: 사용자는 연결된 앱이 로드될 때 기본적인 수준의 유용성을 기대합니다. 단일 버튼과 같은 사소한 기능을 렌더링하기 위해 앱을 만들지 마세요.
  • 자동 리디렉션: 명확하게 표시된 외부 링크를 사용자가 명시적으로 클릭하지 않는 한 외부 웹사이트나 네이티브 앱을 자동으로 실행하지 않습니다.

컨테이너 및 레이아웃

호스트 컨테이너는 모델 대답과 함께 연결된 앱을 표시합니다. 이러한 컨테이너는 해당 Google 제품 전반에서 파트너 저작자 표시, 일관된 테두리, 반응형 크기 조정을 제공합니다.

컨테이너 구조

  1. 헤더: 파트너의 아이콘과 공식 명칭을 표시합니다.
  2. 콘텐츠: 인라인 카드 또는 가로 캐러셀로 표시됩니다.
  3. 응답 텍스트 페어링: 표시 모드는 항상 모델 응답 텍스트와 함께 제공됩니다. 이 결합된 레이아웃을 중심으로 디자인합니다.
  4. UI 스타일: 해당 Google 제품 전반에서 호스트 컨테이너 스타일을 상속합니다.

반응형 동작

연결된 앱은 다양한 컨테이너 너비와 기기 표시 영역에서 렌더링됩니다. 고정된 크기를 사용하지 마세요.

  • 가로 리플로우: 가로 클리핑 없이 작은 사이드바, 모바일 화면, 넓은 데스크톱 피드 간에 깔끔하게 조정되는 유연한 레이아웃을 사용합니다.
  • 콘텐츠를 세로로 맞춤: 인라인 컨테이너가 콘텐츠에 맞게 편안한 읽기 높이까지 커지도록 합니다. 고정된 빈 공간으로 카드를 채우거나 세로 스크롤바에 콘텐츠를 가두지 마세요.
  • 기기 입력 존중: 모바일에서는 기본 터치 동작과 안전 영역을 지원하고 데스크톱에서는 마우스 오버 상태를 지원합니다.

피해야 할 사항

  • 이중 패딩 방지: 연결된 앱에는 시스템 표준을 충족하기 위한 기본 내부 패딩이 포함되어 있습니다. 의도하지 않은 간격을 방지하기 위해 내부 콘텐츠에서 추가 패딩을 삭제합니다.
  • 불균형한 모서리 반경 피하기: 내부 도형을 호스트 컨테이너의 모서리 반경에 비례하게 유지하여 모서리가 지나치게 날카롭거나 둥글지 않도록 합니다.
  • 자체 획 추가 방지: 컨테이너에는 기본적으로 시스템 정의 테두리 스타일이 포함됩니다. 내부 구성요소 주위에 추가 테두리나 선을 적용하지 마세요.

표시 모드

표시 모드는 확장 프로그램이 관련 Google 제품의 응답과 함께 시각적 UI를 직접 표시하는 방식을 정의합니다. 인라인 카드 또는 전체 화면이라는 두 가지 기본 표시 모드 중 하나를 사용합니다.

인라인 카드

인라인 카드는 응답 흐름에 직접 삽입되는 가볍고 단일 목적의 구성요소입니다. 빠른 확인, 구조화된 데이터 검사 또는 단일 단계 작업에는 인라인 카드를 사용합니다.

인라인 카드를 사용해야 하는 경우

  • 상태 업데이트 및 확인
  • 간단한 데이터 표시 또는 선택
  • 선택적 확장 기능이 있는 간단한 요약입니다.
  • 대화를 이어가는 빠른 작업

콘텐츠 밀도 및 자르기 가드레일

  • 제목 클램핑: 헤더가 작업을 보이지 않게 밀어내지 않도록 카드 제목을 줄임표로 잘라 1~2줄로 제한합니다.
  • 본문 및 메타데이터 제한: 보조 문구는 2~3줄로 제한하고 항목별 메타데이터는 스캔 가능한 속성 2~3개로 제한합니다.
  • 간결한 CTA 문구: 동사로 시작하는 액션 라벨(예: '테이블 예약' 또는 '주문 확인')을 사용하고 카드 바닥글을 기본 CTA 1개와 선택적 보조 액션 1개로 제한합니다.

캐러셀 정의: 캐러셀에는 피로감을 유발하지 않으면서 스크롤을 정당화할 수 있도록 3~8개의 카드가 포함되어야 하며, 모든 카드는 동일한 높이와 너비 크기를 유지해야 합니다. 카드 제목은 1~2줄로 제한하고 메타데이터는 카드당 2~3개 필드로 제한합니다.

인라인 카드 상호작용

인라인 카드는 사용자가 대화를 계속할 수 있도록 빠르고 직접적인 작업에 중점을 두어야 합니다.

  • 인라인 작업: 사용자가 카드 내에서 직접 텍스트 수정, 항목 추가, 작업 체크 등의 작업을 실행할 수 있습니다.
  • 상태 업데이트: 항목 내부가 아닌 스레드에 직접 복잡한 사용자 작업을 반영합니다. 예를 들어 사용자가 숙박을 예약하면 대화에 '예약됨' 라벨이 표시된 업데이트된 카드를 생성합니다.
  • 마우스 오버 메커니즘: 탐색 아이콘 버튼은 기본적으로 숨겨져 있으며 컨테이너 위로 마우스를 가져가면 표시됩니다.
  • 오버플로 스크림: 시작 상태는 오른쪽 가장자리 스크림을 표시하고 중간은 양쪽 가장자리를 표시하며 끝은 왼쪽 가장자리를 표시합니다.
  • 터치 동작: 캐러셀 카드 사이에 간격을 두고 기본 가로 스와이프를 사용합니다.
  • 카드 엿보기: 시작 상태는 왼쪽 패딩을 사용하고 중간 상태는 패딩을 사용하지 않으며 종료 상태는 오른쪽 패딩을 사용합니다.

인라인 카드에서 피해야 할 사항

  • 중첩 스크롤 방지: 내부 세로 스크롤바를 포함하지 마세요.
  • 다중 뷰 드릴링 방지: 인라인 카드 내에서 탐색경로, 다중 탭 뷰, 다단계 드릴다운을 사용하지 마세요. 복잡한 흐름을 전체 화면으로 이동합니다.
  • 메뉴 위에 표시되는 컨트롤 피하기: 드롭다운, 팝오버, 컨텍스트 메뉴는 컨테이너 클리핑 및 z-색인 충돌을 일으키므로 사용하지 마세요.
  • 중복 입력 방지: 해당 Google 제품에 이미 입력이 있으므로 카드 내에 다른 입력을 배치하지 마세요.
  • 내부 세로 스크롤 방지: 카드 내부에 스크롤 가능한 컨테이너를 배치하지 마세요. 스크롤 트래핑이 발생하고 모바일 탐색이 저하됩니다.
  • 팝오버 피하기: 팝오버는 콘텐츠를 가리고 UI를 어지럽히므로 도움말이나 팝오버 오버레이를 사용하여 주요 세부정보를 표시하지 마세요.
  • 드롭다운 메뉴 피하기: 드롭다운 선택기 내에 작업을 숨기지 마세요. 기본 작업을 명시적인 버튼으로 노출합니다.
  • 캐러셀에서 스크롤 오버플로 숨기기 방지: 사용자가 스크롤할 수 있는 콘텐츠가 더 있다는 것을 알 수 있도록 인접한 카드가 표시되는지 확인합니다.
  • 맞춤 오류 구성요소 방지: 맞춤 오류 상태를 사용하지 마세요. 호스트 UI는 전체 환경에서 일관되게 표준 오류 구성요소를 제공합니다.
  • 모달 사용 피하기: MCP 앱은 모달을 지원하지 않습니다. 더 많은 공간이 필요한 경우 전체 화면 모드로 전환하는 옵션을 대신 제공하세요.

전체 화면

인라인 카드에 포함할 수 없는 풍부한 다단계 작업이나 데이터가 많은 워크플로를 위한 몰입형 캔버스로 전체 화면 모드를 사용하세요.

전체 화면을 사용해야 하는 경우

  • 부동산 매물, 메뉴, 대화형 지도와 같은 밀도 높은 콘텐츠를 탐색하는 경우
  • 인라인 카드 이외의 전용 공간이 필요한 캔버스 또는 다이어그램 수정과 같은 복잡한 워크플로
  • 데이터 및 분석(예: 풍부한 대시보드, 데이터 시각화, 세부적인 분석 도구 보기)에는 집중이 필요합니다.

전체 화면 레이아웃 및 상호작용

  1. 헤더: 앱 기여 분석 및 작업이 포함된 시스템 제공 헤더 바를 표시합니다.
  2. 안전 영역 인셋: 콘텐츠가 겹치지 않도록 헤더 표시줄 아래에 명확한 간격을 유지합니다.
  3. 닫기 및 열기: 전체 화면으로 열기 버튼과 전체 화면 보기의 헤더에 닫기 버튼을 표시합니다.

전체 화면에서 피해야 할 사항

  • 네이티브 앱 복제 방지: 전체 화면을 사용하여 여러 단계로 이루어진 집중적인 작업에 대한 참여도를 높입니다.
  • 중복 입력 방지: 해당 Google 제품에 이미 입력이 있으므로 파트너는 뷰 내에 다른 입력을 배치해서는 안 됩니다.
  • 플로팅 패널 피하기: 플로팅 모달이나 플로팅 드래그 가능 검사기 툴바는 인터페이스를 복잡하게 만들고 호스트 표시 경로 오버레이와 충돌하므로 사용하지 마세요.
  • 안전 영역 중복 방지: 상호작용 요소가 호스트 표시 경로 툴바 및 시스템 표시기(예: 상태 표시줄, 홈 표시줄)와 겹치지 않도록 합니다.

상호작용 가이드라인

사용자가 연결된 앱 내에서 콘텐츠를 조작하는 방법, 작업이 호스트 대화와 동기화되는 방식, 복잡한 워크플로를 외부 앱 또는 웹사이트에 전달하는 시점입니다.

앱 UI와 대화의 역할 분담

연결된 앱과 대화형 프롬프트를 상호 보완적인 레이어로 설계합니다.

  • 직접 조작을 위해 연결된 앱 UI 사용: 지도 화면 이동, 구조화된 옵션 비교, 다중 필드 양식 컨트롤, 텍스트 프롬프트 입력이 지루하거나 모호한 시각적 선택과 같은 공간 탐색에 UI를 사용합니다.
  • 개방형 인텐트에 호스트 대화 사용: 자연어 후속 조치, 다단계 합성, 광범위한 탐색 쿼리에 대화를 사용합니다.

단계적 공개

  • 점진적 공개: 사용자의 요구에 부합하는 가장 간결한 표시 모드(인라인 카드 또는 캐러셀)로 시작하여 필요에 따라 보조 세부정보를 표시하고(더보기) 심층 탐색이 필요한 경우에만 전체 화면으로 확대합니다.
  • 숨겨진 메뉴보다 표시되는 컨트롤: 마우스 오버 전용 툴바, 마우스 오른쪽 버튼 클릭 컨텍스트 메뉴 또는 모바일 표시 영역에서 실패하는 길게 누르기 동작 내에 기본 작업을 숨기지 않고 명시적인 버튼이나 전환 버튼으로 노출합니다.

외부 핸드오프 및 외부 연결

일부 기능은 삽입된 iframe의 범위를 초과하거나 네이티브 OS 및 하드웨어 기능이 필요합니다. 앱 또는 사이트로 연결되는 링크를 사용하는 경우:

  • 네이티브 OS 또는 하드웨어 종속 기능(예: 실시간 탐색, 카메라 또는 센서 캡처, 지속적인 백그라운드 오디오 및 위치 추적)
  • 규제 대상 또는 보안에 민감한 흐름(예: 최종 결제 또는 본인 인증)
  • 전체 화면을 넘어서는 심층적인 작업공간(예: 모든 기능을 갖춘 저작 도구 모음 또는 복잡한 엔터프라이즈 대시보드)

인수인계 설계

  • 명확한 외부 링크 어포던스 표시: 항상 외부 핸드오프 버튼을 명시적인 실행 표시기(예: open_in_new 아이콘) 및 대상별 라벨(예: 'Google 지도에서 열기')과 페어링합니다.
  • 컨텍스트가 보존된 딥 링크: 호스트의 외부 링크 API(openLink)를 통해 대화에서 설정된 모든 파라미터를 딥 링크 URL에 전달하므로 사용자가 앱을 전환한 후 선택 항목을 다시 입력할 필요가 없습니다.

피해야 할 사항

  • 자동 리디렉션 방지: 사용자를 호스트 표시 경로에서 자동으로 이동시키지 마세요. 호스트 표시 경로를 벗어나려면 항상 사용자가 명시적으로 클릭해야 합니다.
  • '티저' 또는 링크 전용 카드 방지: 사용자를 웹사이트로 이탈시키는 정적 배너 또는 버튼을 렌더링하는 것이 유일한 목적인 연결된 앱을 빌드하지 마세요.
  • 예고 없는 컨텍스트 전환 방지: 외부 앱이나 브라우저 탭을 연다는 표시 없이 외부 링크의 스타일을 카드 내 작업과 동일하게 지정하지 마세요.

시각적 가이드라인

해당 Google 제품은 인지 부하를 줄이기 위해 가볍고 중립적인 UI 요소와 부드러운 대비를 우선시합니다.

시각적 원칙

연결된 앱 전반에서 시각적 밀도와 미학을 제어하기 위해 핵심 디자인 원칙을 적용합니다.

  • 더 가볍고 미니멀한 UI: 선과 컨테이너 요소를 줄여 깔끔한 시각적 밀도를 유지합니다.
  • 중성색 균형: 중성 회색 음영을 우선시하고 기본 CTA에 강조 색상을 사용합니다.
  • 고도: 부드러운 표면 채우기를 적용하여 그림자 효과를 전체 화면 모드와 캐러셀 탐색 컨트롤에만 제한합니다.
  • 스타일 상속: 색상, 서체, 모서리 반경을 적용하여 앱이 모든 관련 Google 제품에서 네이티브 앱처럼 느껴지도록 합니다.

색상

해당 Google 제품은 색상을 두 가지 기능 그룹으로 구성합니다. 구조적 레이아웃을 위한 시스템 색상과 기본 브랜드 순간을 위한 강조 색상입니다. 이러한 시맨틱 역할을 사용하면 제품 전반에서 명확한 시각적 계층 구조와 자동 테마 조정이 보장됩니다.

시스템 색상 역할

연결된 앱 전반에서 구조적 색상을 일관된 UI 역할에 매핑합니다.

  • 배경 표면: 카드 컨테이너 및 중첩된 그룹화에 호스트에서 제공하는 중립 표면 색상을 사용합니다. 맞춤 단색 채우기, 그라데이션 또는 패턴으로 컨테이너 배경을 재정의하지 마세요.
  • 텍스트 및 콘텐츠 계층 구조: 제목과 키 값에는 기본 콘텐츠 색상을, 본문 문구와 보조 라벨에는 보조 음소거 톤을, 운영 메타데이터에는 시맨틱 상태 색상(긍정, 경고, 중요)을 사용합니다.
  • 테두리 및 구분선: 구조적 테두리와 구분선에 은은한 시스템 윤곽선 색상을 사용하여 시각적 무게감을 더하지 않고 콘텐츠를 구분합니다.
  • 기본 강조: 기본 클릭 유도 문구 버튼에 시스템 강조 또는 파트너 브랜드 색상을 사용합니다.

파트너 브랜드 적용 영역

연결된 앱 전반에서 파트너 브랜드 색상 배치를 안내합니다.

  • 권장사항: 기본 CTA 버튼, 로고, 주요 하이라이트 순간에 브랜드 색상을 선택적으로 적용합니다.
  • 권장하지 않음: 카드 배경, 본문 텍스트, 제목, 구조적 테두리 또는 보조 대화형 컨트롤에 브랜드 색상을 적용하지 마세요.

테마 및 밝은/어두운 모드

연결된 앱은 밝은 테마와 어두운 테마, 동적 표면 팔레트 전반에서 일관된 느낌을 주어야 합니다.

  • 정적 16진수 값 대신 시맨틱 토큰 사용: 표면, 텍스트, 테두리를 호스트 표면의 시맨틱 색상 토큰에 바인딩하여 인터페이스가 밝은 모드와 어두운 모드 간에 자동으로 조정되도록 합니다.
  • 두 테마에 맞게 브랜드 강조 색상 조정: 기본 브랜드 색상이 어두운 표면에서 너무 어둡거나 지나치게 선명하게 표시되는 경우 어두운 모드에서 약간 더 밝거나 채도가 낮은 변형을 제공하여 두 테마에서 브랜드 강조 색상이 접근성 대비를 유지하도록 합니다.
  • 테마에 적합한 미디어 및 로고 사용: 어두운 모드에서 선명한 흰색 경계 상자가 표시되지 않도록 투명한 배경으로 아이콘, 로고, 일러스트레이션을 내보냅니다.

아이콘

연결된 앱은 깔끔한 윤곽선 아이콘을 사용하여 관련 Google 제품 전반에서 시각적 조화와 가독성을 유지합니다.

아이콘 스타일 및 크기

연결된 앱 전반의 아이콘 도형, 색상, 크기 기준을 안내합니다.

  • 윤곽선이 있는 둥근 도형: 균일한 선 두께와 둥근 캡이 있는 단색 윤곽선 아이콘(예: Google Material Symbols Outlined) 또는 호스트 인터페이스의 시각적 무게감과 일치하는 조화로운 파트너 아이콘 세트를 사용합니다.
  • 중립 색조: 브랜드 색상이 아닌 기본 또는 보조 콘텐츠 색상을 사용하여 기능 UI 아이콘에 색조를 적용합니다. 그러면 아이콘이 기본 CTA와 경쟁하지 않고 읽기 계층 구조를 지원합니다.
  • 크기 경계: 표시 영역 전반에서 가독성과 비율을 유지하려면 아이콘을 16px(소형 인라인 메타데이터의 경우)에서 32px(눈에 띄는 카드 또는 기능 헤더의 경우) 사이로 유지하세요.

접근성

해당 Google 제품은 WCAG 2.1 AA 및 Material Design 3 표준에 따라 접근성 규정 준수를 시행합니다.

핵심 접근성 요소

  • 색상 대비: 밝은 테마와 어두운 테마 전반에서 노출 영역 배경 대비 텍스트에 대해 최소 4.5:1의 WCAG AA 대비율을 적용합니다.
  • 최소 텍스트 크기: 13pt 글꼴 크기를 적용합니다.
  • 터치 영역: 컨트롤의 대화형 타겟 영역을 모바일의 경우 최소 48x48px, 데스크톱의 경우 24x24px로 적용합니다.
  • 키보드 포커스: 대화형 카드 구성요소 전반에서 표시되는 포커스 표시기 링과 논리적 탭 순회 순서를 유지합니다.
  • 동적 미디어 대체 텍스트: 파트너가 제공하는 모든 이미지, 썸네일, 지도 핀, 데이터 시각화에 설명 대체 텍스트를 제공합니다.
  • 실시간 상태 공지(aria-live): aria-live="polite" 영역을 사용하여 '더보기' 행 펼치기, 항목 필터링, 인라인 작업 완료와 같은 동적 카드 내 상태 변경을 공지합니다.
  • 모션 감소(prefers-reduced-motion): 스켈레톤 반짝임 효과와 캐러셀 슬라이드 전환을 정적 또는 즉각적인 상태 변경으로 대체하여 사용자의 prefers-reduced-motion 미디어 쿼리를 따릅니다.
  • 콘텐츠 오버플로 및 잘림: 긴 텍스트 블록을 3~5줄로 제한하고 액세스 가능한 '더보기' 작업을 제공하여 레이아웃이 깨지지 않도록 하고 가독성을 유지합니다.