Google Workspace 부가기능으로 Gmail 확장하기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
많은 이메일의 목적은 수신자가 캘린더 일정 추가, 양식 작성, 예약, 기타 애플리케이션 사용과 같은 특정 작업을 수행하거나 목표를 달성하도록 하는 것입니다. 하지만 수신자는 추가 메시지 없이 작업을 완료해야 하며, 수동으로 여러 단계를 수행해야 하는 경우가 많습니다.
Google Workspace 부가기능으로 이러한 작업을 자동화하여 사용자의 시간과 노력을 절약할 수 있습니다. 사용자가 Gmail에서 메시지를 읽거나 작성할 때 Google Workspace 부가기능은 사용자가 다음과 같은 다양한 방식으로 메시지에 대해 조치를 취할 수 있는 맞춤형 대화형 UI를 표시할 수 있습니다.
- Gmail UI에 사용자에 대한 추가 정보를 표시합니다.
- Google 이외의 서비스에 연결하여 정보를 가져오거나 다른 작업을 실행합니다.
- 부가기능 동작을 제어하거나 다른 서비스에 정보를 전송하는 수단을 제공합니다.
Google Workspace 부가기능은 Gmail 내에서 다음과 같은 종류의 확장 프로그램을 정의할 수 있습니다.
또한 Gmail을 확장하는 Google Workspace 부가기능은 데스크톱 및 모바일 클라이언트 모두에서 작동합니다.
Gmail 홈페이지
Gmail은 Google Workspace 부가기능 홈페이지 표시를 지원합니다.
Gmail에 애드온의 일반 홈페이지를 표시하려면 애드온의 매니페스트에 addOns.gmail
필드가 있는지 확인하면 됩니다.
또는 Gmail 전용 홈페이지를 제공하기 위해 부가기능 매니페스트에 gmail.homepageTrigger
를 추가합니다.
어떤 경우든 부가기능의 스크립트 프로젝트에 홈페이지 트리거 함수의 이름을 제공해야 합니다. 이 함수는 필요할 때 Gmail 홈페이지를 빌드하기 위해 자동으로 호출됩니다. 이 함수를 구현하여 홈페이지를 구성하는 단일 Card
또는 Card
객체 배열을 빌드하고 반환해야 합니다. 홈페이지 트리거 함수에는 클라이언트의 플랫폼과 같은 일반적인 정보가 포함된 이벤트 객체가 매개변수로 전달됩니다. 이벤트 객체 데이터를 사용하여 홈페이지의 구성을 맞춤설정할 수 있습니다.
만들 수 있는 항목 확인하기
Google Workspace 부가기능은 Apps Script를 사용하여 빌드되며 인터페이스는 Apps Script 카드 서비스를 사용하여 정의됩니다. 개요는 Google Workspace 부가기능 빌드를 참고하세요. Google Workspace 부가기능 동작은 Gmail 관련 섹션이 포함된 매니페스트를 사용하여 구성됩니다.
Gmail을 확장하도록 Google Workspace 부가기능을 구성할 때는 부가기능에 만들 인터페이스와 부가기능이 취할 수 있는 작업을 결정해야 합니다.
자세한 내용은 다음 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eGoogle Workspace add-ons automate tasks within Gmail, saving users time and effort by providing interactive UI elements within emails.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons enhance the Gmail experience by displaying extra information, connecting to external services, and letting users control add-on behavior.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can build custom add-ons with Apps Script and the Card service to extend Gmail's functionality on both desktop and mobile.\u003c/p\u003e\n"],["\u003cp\u003eGmail add-ons can have homepages, contextual interfaces triggered by opening or composing emails, and the ability to create new drafts automatically.\u003c/p\u003e\n"],["\u003cp\u003eTo learn more about building and configuring Gmail add-ons, explore the provided resources on extending UI, composing messages, manifests, and scopes.\u003c/p\u003e\n"]]],["Google Workspace add-ons automate tasks within Gmail, saving users time. They enable interactive UIs when users read or compose messages, allowing actions like displaying information, connecting to external services, and controlling add-on behavior. Add-ons can create contextual interfaces for messages and compose actions, or automatically generate drafts. Developers can define homepages and other interfaces, customize them with event objects, and use Apps Script to build and configure these add-ons through manifests. They support both desktop and mobile Gmail clients.\n"],null,["# Extending Gmail with Google Workspace add-ons\n\nThe purpose of many emails is to get the recipient to do a specific task or\nreach a goal, such as adding a calendar event, filling out a form, making a\nreservation, or using other applications. However, recipients then have to\ncomplete the task without any further prompting, often doing a number of\nmanual steps.\n\nYou can save time and effort for your users by automating these tasks with\nGoogle Workspace add-ons. When a user reads or composes a message in Gmail,\na Google Workspace add-on can present an interactive, customized UI that lets\nthe user act on the message in various ways, such as by:\n\n- Displaying additional information for the user in the Gmail UI.\n- Connecting to non-Google services, to retrieve information or take other actions.\n- Providing the means to control the add-on behavior or send information to another service.\n\n| **Note:** You can also [develop your own chatbots](/hangouts/chat) to enhance the Gmail experience.\n\nGoogle Workspace add-ons can define the following kinds of extensions within\nGmail:\n\n- [Homepages](/workspace/add-ons/concepts/homepages) and other non-contextual cards.\n- Contextual interfaces that appear when users [open Gmail messages](/workspace/add-ons/gmail/extending-message-ui).\n- Contextual interfaces that appear when a user [composes a message or reply](/workspace/add-ons/gmail/extending-compose-ui).\n- Automatically [create new message drafts](/workspace/add-ons/gmail/compose) in response to user interactions.\n\nIn addition, Google Workspace add-ons that extend Gmail do so on both desktop and mobile\nclients.\n\nGmail homepages\n---------------\n\nGmail supports displaying Google Workspace add-on\n[homepages](/workspace/add-ons/concepts/homepages).\nTo show your add-on's common homepage in Gmail simply make sure there\nis a [`addOns.gmail`](/apps-script/manifest/addons#AddOns.FIELDS.gmail)\nfield in the add-on's manifest.\n\nAlternatively, add a\n[`gmail.homepageTrigger`](/apps-script/manifest/gmail-addons#Gmail.FIELDS.homepageTrigger)\nto the add-on manifest to provide a Gmail-specific homepage.\n\nIn either case, you must provide the name of a homepage trigger function in your\nadd-on's script project. This function is automatically called to build the\nGmail homepage when it is needed. You must implement this function to build\nand return a single\n[`Card`](/apps-script/reference/card-service/card) or an array of\n[`Card`](/apps-script/reference/card-service/card)\nobjects that make up the homepage. The homepage trigger function is passed an\n[event object](/workspace/add-ons/concepts/event-objects)\nas a parameter that contains some general information such as the client's\nplatform. You can use the event object data to tailor the construction of the\nhomepage.\n\nSee what you can make\n---------------------\n\nGoogle Workspace add-ons are built using [Apps Script](/apps-script), and their\ninterfaces defined using the Apps Script\n[Card service](/apps-script/reference/card-service). See\n[Building Google Workspace add-ons](/workspace/add-ons/how-tos/building-workspace-addons)\nfor an overview. Google Workspace add-on behavior is configured using a\n[manifest](/workspace/add-ons/concepts/workspace-manifests), which includes\nGmail-specific sections.\n\nWhen configuring your Google Workspace add-on to extend Gmail, you must\ndecide what interfaces to create for your add-on and what actions it can take.\nSee the following guides for more information:\n\n- [Extending the message UI](/workspace/add-ons/gmail/extending-message-ui)\n- [Extending the compose UI with compose actions](/workspace/add-ons/gmail/extending-compose-ui)\n- [Compose draft messages](/workspace/add-ons/gmail/compose)\n- [Manifests](/workspace/add-ons/concepts/workspace-manifests)\n- [Gmail scopes](/workspace/add-ons/concepts/workspace-scopes#gmail_add-on_scopes)\n- Try a sample: [Analyze and label Gmail messages with Gemini and Vertex AI](/workspace/add-ons/samples/gmail-sentiment-analysis-ai)"]]