Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Add-on Google Workspace menampilkan informasi dan kontrol pengguna di sidebar UI aplikasi host. Add-on terdiri dari toolbar identifikasi utama beserta satu atau beberapa
kartu.
Setiap kartu mewakili 'halaman' tertentu di UI add-on Anda, dan
beralih ke kartu baru
biasanya hanya perlu membuat kartu tersebut dan
mendorongnya ke tumpukan kartu internal.
Anda dapat menentukan alur navigasi antar-kartu untuk pengalaman interaksi yang kaya.
Kartu dapat berupa non-kontekstual atau kontekstual. Kartu kontekstual ditampilkan kepada pengguna saat aplikasi host berada dalam konteks tertentu. Misalnya, saat membuka pesan Gmail atau acara Kalender. Kartu non-kontekstual (seperti
halaman beranda) ditampilkan kepada pengguna
di luar konteks host tertentu. Misalnya, saat pengguna melihat kotak masuk Gmail, folder utama Drive, atau Kalender.
Add-on Google Workspace yang dibuat di Apps Script menggunakan
layanan Kartu untuk membuat antarmuka pengguna dari
kartu. Add-on yang dibuat dalam bahasa lain harus menampilkan JSON yang diformat dengan benar agar antarmuka dirender sebagai kartu.
Setiap kartu terdiri dari header dan satu atau beberapa bagian kartu. Setiap bagian terdiri dari serangkaian widget. Widget
menampilkan informasi kepada pengguna atau menyediakan kontrol interaksi seperti tombol.
Antarmuka berbasis kartu memiliki manfaat berikut:
Tidak diperlukan pengetahuan tentang HTML atau CSS untuk membuat antarmuka berbasis kartu.
Kartu dan widget otomatis diberi gaya agar berfungsi dengan baik dengan aplikasi Google Workspace yang diperluasnya.
Antarmuka berbasis kartu berfungsi di perangkat desktop dan seluler, tetapi Anda hanya perlu menentukan antarmuka satu kali.
Membuat antarmuka berbasis kartu
Saat membuat add-on berbasis kartu, penting untuk memahami konsep dan pola desain tertentu. Panduan berikut memberikan informasi yang Anda perlukan untuk membuat add-on berbasis kartu yang efektif:
Lihat halaman ini saat membuat kartu dan menerapkan
perilaku UI. Anda juga dapat menemukan contoh tambahan berikut yang berguna sebagai referensi saat menerapkan add-on:
Contoh add-on ini menunjukkan contoh add-on Google Workspace yang lebih kompleks, yang menampilkan informasi pengguna tentang penerima pesan Gmail, editor file Drive, atau tamu acara Kalender. Anda hanya dapat menggunakan add-on ini di dalam domain, karena add-on ini menggunakan Directory API untuk mengambil informasi pengguna.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-04 UTC."],[[["\u003cp\u003eGoogle Workspace add-ons use cards to build user interfaces within the host application's sidebar, offering navigation and interactive elements.\u003c/p\u003e\n"],["\u003cp\u003eCards can be contextual, appearing in specific situations like opening an email, or non-contextual, like when viewing your inbox.\u003c/p\u003e\n"],["\u003cp\u003eCard-based interfaces are built using cards, widgets, and actions, offering a structured way to present information and controls.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons built with Apps Script utilize the Card service, while other languages require formatted JSON for card rendering.\u003c/p\u003e\n"],["\u003cp\u003eThese interfaces are automatically styled, responsive across devices, and require no HTML/CSS knowledge for basic creation.\u003c/p\u003e\n"]]],["Google Workspace add-ons utilize card-based UIs within host applications, comprising a toolbar and multiple cards. These cards, representing UI pages, are built using the Card service or JSON. Navigation involves pushing new cards onto a stack. Cards can be contextual, appearing in specific host application states, or non-contextual, like homepages, visible in general views. Each card contains sections composed of widgets, offering information or interaction controls. Key actions include defining card navigation, constructing cards with sections and widgets, and implementing actions.\n"],null,["| **Note:** Google Workspace add-ons are card-based. Editor add-ons are [HTML-based](/workspace/add-ons/concepts/html-interfaces).\n\nGoogle Workspace add-ons present information and user\ncontrols in the sidebar of the\n[host application](/workspace/add-ons/guides/glossary#host_or_host_application)\nUI. An add-on consists of a main identifying toolbar along with one or more\n[cards](/workspace/add-ons/concepts/cards).\n\nEach card represents a particular 'page' of your add-on's UI, and\n[navigating to a new card](/workspace/gmail/add-ons/how-tos/navigation) is\nusually just a matter of creating that card and\n[pushing it onto an internal card stack](/workspace/gmail/add-ons/how-tos/navigation#navigation_methods).\nYou can define navigation flows between cards for a rich interaction experience.\n\nCards can be *non-contextual* or *contextual* . Contextual cards are presented\nto the user when the host application is in a specific context. For example,\nwhen opening a Gmail message or Calendar event. Non-contextual cards (such as\n[homepages](/workspace/add-ons/concepts/homepages)) are presented to the user\noutside of a specific context of the host. For example, when the user is\nviewing their Gmail inbox, main Drive folder, or Calendar.\n\nGoogle Workspace add-ons built in Apps Script use the\n[Card service](/apps-script/reference/card-service/card-service) to create user interfaces out of\n[cards](/workspace/add-ons/concepts/cards). Add-ons built in other languages\nmust return properly formatted JSON for the interface to render as cards.\n\nEach card consists of a header and one or more card sections. Each section is\ncomposed of a set of [widgets](/workspace/add-ons/concepts/widgets). Widgets\ndisplay information to the user or provide interaction controls like buttons.\n\nCard-based interfaces have the following benefits:\n\n- No knowledge of HTML or CSS is needed to create card-based interfaces.\n- Cards and widgets are automatically styled to work well with the Google Workspace applications they extend.\n- Card-based interfaces work on both desktop and mobile devices, but you only\n need to define the interface once.\n\n | **Note:** Gmail is currently the only host application that can be extended by Google Workspace add-ons on mobile.\n\nCreating card-based interfaces\n\nWhen building card-based add-ons, it's important to understand certain\nconcepts and design patterns. The following guides provide the information\nyou need to build effective card-based add-ons:\n\n- [Cards](/workspace/add-ons/concepts/cards)\n- [Homepages](/workspace/add-ons/concepts/homepages)\n- [Widgets](/workspace/add-ons/concepts/widgets)\n- [Actions](/workspace/add-ons/concepts/actions)\n- [Event objects](/workspace/add-ons/concepts/event-objects)\n- [Constructing cards](/workspace/add-ons/how-tos/building-workspace-addons#constructing_cards)\n- [Building interactive cards](/workspace/add-ons/how-tos/interactions)\n- [Navigating between cards](/workspace/add-ons/how-tos/navigation)\n- [Using universal actions](/workspace/add-ons/how-tos/universal-actions)\n- [Adding autocomplete to text inputs](/workspace/add-ons/how-tos/suggestions)\n- [Accessing user locales and timezones](/workspace/add-ons/how-tos/access-user-locale)\n- [Connecting to non-Google services](/workspace/add-ons/how-tos/non-google-services)\n- [Style guide](/workspace/add-ons/guides/workspace-style)\n- [Best Practices](/workspace/add-ons/guides/workspace-best-practices)\n\nReference these pages when creating cards and implementing\nUI behavior. You may also find the following additional samples useful to\nreference when implementing your add-on:\n\n- [Google Workspace add-on \"Cats\" quickstart](/workspace/add-ons/cats-quickstart)\n\n This add-on sample shows a simple Google Workspace add-on UI with multiple pages and\n homepages.\n- [Google Workspace add-on: \"Translate\"](/workspace/add-ons/translate-addon-sample)\n\n This add-on sample shows a Google Workspace add-on that lets users translate text from\n within Docs, Sheets, and Slides.\n- [Google Workspace add-on: \"Teams List\"](/workspace/add-ons/teams-addon-sample)\n\n This add-on sample shows a more complex\n Google Workspace add-on sample, that shows\n user information about Gmail message recipients, Drive file editors, or\n Calendar event attendees. You can only use this add-on inside a domain, since\n it uses the [Directory API](/workspace/admin/directory) to retrieve\n user information."]]
