홈페이지 트리거 매니페스트 리소스
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google Workspace 부가기능
홈페이지 트리거를 정의하는 데 사용되는 리소스 구성입니다.
HomepageTrigger
홈페이지 트리거의 Google Workspace 부가기능 매니페스트 구성입니다.
홈페이지 트리거는 addOns.common.homepageTrigger 리소스나 개별 호스트 애플리케이션의 리소스에 정의할 수 있습니다.
정의되고 사용 설정된 경우 호스트 애플리케이션의 홈페이지 트리거는 addOns.common.homepageTrigger에 정의된 홈페이지 트리거를 재정의합니다.
자세한 내용은 홈페이지 구성을 참고하세요.
| JSON 표현 |
{
"enabled": boolean,
"runFunction": string
} |
| 필드 |
enabled |
boolean
이 호스트 애플리케이션에 홈페이지 (비컨텍스트) 카드가 사용 설정되어 있는지 여부입니다. 기본값은 true입니다.
|
runFunction |
string
이 트리거가 실행될 때 실행할 함수의 이름입니다. 지정된 경우 이 함수를 구현하여 이 호스트 애플리케이션에서 이 부가기능의 홈페이지로 표시할 하나 이상의 Card 객체의 배열을 빌드하고 반환해야 합니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eHomepage triggers define the configuration for Google Workspace Add-on homepages, letting you control card display and functionality.\u003c/p\u003e\n"],["\u003cp\u003eThese triggers can be set globally or for specific host applications, with host-specific settings taking precedence.\u003c/p\u003e\n"],["\u003cp\u003eHomepage triggers are configured using the \u003ccode\u003eenabled\u003c/code\u003e and \u003ccode\u003erunFunction\u003c/code\u003e fields within the add-on's manifest file.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003erunFunction\u003c/code\u003e field points to a function that constructs and returns \u003ccode\u003eCard\u003c/code\u003e objects to populate the add-on's homepage.\u003c/p\u003e\n"]]],[],null,["# HomepageTrigger manifest resource\n\nThe resource configuration that is used to define\n[Google Workspace add-on](/workspace/add-ons/concepts/types#g_suite_add-ons)\n[homepage triggers](/workspace/add-ons/concepts/homepages#homepage_configuration).\n\nHomepageTrigger\n---------------\n\nThe Google Workspace add-on manifest configuration for\n[homepage triggers](/workspace/add-ons/concepts/homepages#homepage_configuration).\n\nHomepage triggers can be defined in the\n[`addOns.common.homepageTrigger`](/apps-script/manifest/addons#Common.FIELDS.homepageTrigger)\nresource or the resources of the individual\n[host applications](/workspace/add-ons/guides/glossary#host_or_host_application).\nThe homepage trigger of a host application, if defined and enabled, overrides\nthe homepage trigger defined in\n[`addOns.common.homepageTrigger`](/apps-script/manifest/addons#Common.FIELDS.homepageTrigger).\n\nSee [Homepage configuration](/workspace/add-ons/concepts/homepages#homepage_configuration)\nfor more details.\n\n| JSON representation |\n|-----------------------------------------------------------|\n| ```text { \"enabled\": boolean, \"runFunction\": string } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `enabled` | `boolean` Whether or not homepage (non-contextual) cards are enabled for this host application. Defaults to `true`. |\n| `runFunction` | `string` The name of the function to run this trigger fires. If specified, you must implement this function to build and return an array of one or more [`Card`](/apps-script/reference/card-service/card) objects for display as this add-on's homepage in this host application. |"]]
