홈페이지는 새로운 Google Workspace 부가기능입니다. 하나 이상의 비문맥 카드를 정의하는 기능을 제공합니다. 비문맥 카드는 사용자가 특정 상황에서 벗어나는 경우(예: 사용자가 Gmail 받은편지함을 보고 있는 경우) 메일이나 임시보관 메일을 열지 않은 경우
홈페이지에서처럼 Google Apps 빠른 액세스 측면 패널 (Keep, Calendar, Tasks) 또한 홈페이지에서 사용자가 부가기능을 처음 열 때를 위한 공간으로, 새로운 사용자가 부가기능과 어떻게 상호작용하는지 설명합니다.
프로젝트에 부가기능을 지정하여 부가기능의 홈페이지를 정의할 수 있습니다.
하나 이상의 homepageTrigger
함수 구현(
홈페이지 구성).
부가기능이 있는 각 호스트 애플리케이션마다 하나씩, 여러 개의 홈페이지를 가질 수 있습니다. 확장됩니다. 하나의 공통 기본 홈페이지를 정의할 수도 있는데, 맞춤 홈페이지를 지정하지 않은 호스트에서 사용되는지 확인합니다.
다음 조건 중 하나가 충족되면 부가기능 홈페이지가 표시됩니다.
- 승인 후 부가기능이 호스트에서 처음 열릴 때
- 사용자가 컨텍스트 컨텍스트에서 비컨텍스트 컨텍스트로 전환하는 경우 권한을 부여할 수 있습니다 예를 들어 캘린더 일정을 수정하거나 기본 캘린더로 이동합니다.
- 사용자가 뒤로 버튼을 충분히 클릭했을 때 다른 모든 카드를 내부 스택에서 팝합니다.
- 비문맥 카드의 UI 상호작용으로 인해
Navigation.popToRoot()
드림 있습니다.
홈페이지 디자인은 필수는 아니지만 사용하는 것이 좋습니다. 정의하지 않은 경우 일반 카드가 표시됩니다. 사용자가 다른 방법으로 탐색할 때마다 부가기능 이름이 포함된 할 수 있습니다.
홈페이지 구성
Google Workspace 부가기능은
addOns.common.homepageTrigger
드림
기본 홈페이지 (문맥이 아닌) 부가기능 콘텐츠를 구성하는
모든 호스트 애플리케이션이
매니페스트:
{
// ...
"addOns": {
// ...
"common": {
// ...
"homepageTrigger": {
"runFunction": "myFunction",
"enabled": true
}
}
}
}
runFunction
: Google Workspace 부가기능 프레임워크는 홈페이지 부가기능 카드를 렌더링하도록 호출합니다. 이 함수는 홈페이지 트리거 함수입니다. 이 함수는Card
의 배열을 반환합니다. 홈페이지 UI를 구성하는 객체입니다. 두 개 이상의 카드가 반환되면 사용자가 선택할 수 있는 카드 헤더를 목록으로 표시하는 호스트 애플리케이션 from( 여러 카드 반품).enabled
: 이 범위에 홈페이지 카드를 사용 설정해야 하는지 여부입니다. 이 필드는 선택사항이며 기본값은true
입니다.false
로 설정하면 다음이 발생합니다. 모든 호스트에서 홈페이지 카드를 사용 중지 (해당 호스트에서 재정의하지 않는 한) host; 아래 참조).
공통 구성 외에도
각 호스트 애플리케이션의
구성(addOns.gmail.homepageTrigger
, addOns.calendar.homepageTrigger
)
기타 등등:
{
...
"addOns": {
...
"common": {
// By default, call 'buildHomePage' to render homepage content
// in all hosts. Since calendar.homepageTrigger below overrides
// this in Calendar and Drive and the homepageTrigger is disabled
// for Gmail, this homepage function never executes.
"homepageTrigger": { "runFunction": "buildHomePage" }
},
"calendar": {
// Show customized homepage content for Calendar only.
"homepageTrigger": { "runFunction": "buildCalendarHomepage" }
},
"drive": {
// Show customized homepage content for Drive only.
"homepageTrigger": { "runFunction": "buildDriveHomepage" }
}
"gmail": {
// Disable homepage add-on content in Gmail.
"homepageTrigger": { "enabled": false }
},
...
}
}
이는 다음 매니페스트 발췌 내용과 동일합니다.
{
...
"addOns": {
...
"common": { /* ... */ }, // Omitted a default homepageTrigger specification.
"calendar": {
// Show customized homepage content for Calendar only.
"homepageTrigger": { "runFunction": "myCalendarFunction" }
},
"drive": {
// Show customized homepage content for Drive only.
"homepageTrigger": { "runFunction": "myDriveFunction" }
}
"gmail": { /* ... */ },
...
}
}
homepageTrigger
섹션은 모두 필수 항목이 아닙니다. 그러나
어떤 호스트 제품의 부가기능이든
해당 매니페스트 필드 및 관련된
homepageTrigger
다음 예는 어떤 부가기능 트리거 함수를 보여주는지 보여줍니다.
다양한 매니페스트의 홈페이지 UI를 만들기 위해 실행됩니다 (있는 경우).
구성:
홈페이지 이벤트 객체
호출하면 위에서 설명한 홈페이지 트리거 함수 (runFunction
)는 다음과 같습니다.
이벤트 객체를 전달함
호출 컨텍스트의 데이터가 포함됩니다.
홈페이지 이벤트 객체에 위젯 또는 문맥 정보가 포함되지 않습니다. 전달되는 정보는 다음과 같이 제한됩니다. 공통 이벤트 객체 필드:
commonEventObject.clientPlatform
commonEventObject.hostApp
commonEventObject.userLocale
및commonEventObject.userTimezone
(그러나 사용자 언어 및 시간대 액세스를 참고하세요. 를 참조하세요.
자세한 내용은 이벤트 객체를 참고하세요.
기타 비문맥 카드
부가기능 UI에는 홈페이지. 예를 들어 홈페이지에 '설정' 사용자가 부가기능 설정 (예: 대부분의 경우 맥락과 무관하므로 비맥락적임).
비문맥 카드는 다른 카드와 마찬가지로 제작됩니다. 유일한 차이점은 카드를 생성하고 표시하는 작업이나 이벤트가 무엇인지를 나타냅니다. 자세한 내용은 탐색 메서드 를 참조하세요.