Text
z etykietą tekstową. W razie potrzeby możesz ustawić kolor tła i dezaktywować przycisk.
Dostępne w przypadku dodatków do Google Workspace i aplikacji Google Chat.
const textButton = CardService.newTextButton() .setText('Open Link') .setOpenLink(CardService.newOpenLink().setUrl( 'https://www.google.com'));
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
set | Text | Ustawia tekst zastępczy przycisku na potrzeby ułatwień dostępu. |
set | Text | Ustawia działanie autoryzacji, które otwiera URL do procesu autoryzacji po kliknięciu obiektu. |
set | Text | Ustawia kolor tła przycisku Text . |
set | Text | Po kliknięciu obiektu ustawia działanie, które tworzy wersję roboczą e-maila. |
set | Text | Określa, czy przycisk jest wyłączony. |
set | Text | Ustawia wstępnie zdefiniowany Icon do wyświetlania na przycisku. |
set | Text | Ustawia adres URL obrazu, który ma być używany jako ikona tego przycisku. |
set | Text | Umożliwia skonfigurowanie ikony w ramach projektu Material Design. |
set | Text | Określa działanie, które jest wykonywane po kliknięciu obiektu. |
set | Text | Ustawia działanie, które otwiera URL w karcie po kliknięciu obiektu. |
set | Text | Ustawia adres URL, który zostanie otwarty po kliknięciu obiektu. |
set | Text | Ustawia menu, które otwiera się po kliknięciu obiektu. |
set | Text | Określa tekst wyświetlany na przycisku. |
set | Text | Ustawia styl przycisku. |
Szczegółowa dokumentacja
set Alt Text(altText)
Ustawia tekst zastępczy przycisku na potrzeby ułatwień dostępu. Jeśli nie jest ustawiony, przyjmuje domyślnie tekst wyświetlany na przycisku.
Parametry
Nazwa | Typ | Opis |
---|---|---|
alt | String | Tekst zastępczy do przypisania do tego przycisku. |
Powrót
Text
– ten obiekt do łańcucha.
set Authorization Action(action)
Ustawia działanie autoryzacji, które otwiera URL do procesu autoryzacji po kliknięciu obiektu. Spowoduje to otwarcie adresu URL w nowym oknie. Gdy użytkownik zakończy proces autoryzacji i powróci do aplikacji, wtyczka zostanie ponownie załadowana.
Obiekt interfejsu może mieć tylko jeden z tych parametrów: set
, set
, set
, set
lub set
.
// ... const action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
Parametry
Nazwa | Typ | Opis |
---|---|---|
action | Authorization | Obiekt określający działanie autoryzacyjne, które ma zostać wykonane po kliknięciu tego elementu. |
Powrót
Text
– ten obiekt do łańcucha.
set Background Color(backgroundColor)
Ustawia kolor tła przycisku Text
. Jeśli nie ustawisz koloru dodatkowego dla przycisku Text
, zostanie użyty kolor dodatkowy zdefiniowany w manifest dodatku.
Ta metoda nie działa w przypadku przycisków Text
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
background | String | Kolor w formacie #rgb. |
Powrót
Text
– ten obiekt do łańcucha.
set Compose Action(action, composedEmailType)
Po kliknięciu obiektu ustawia działanie, które tworzy wersję roboczą e-maila. Obiekt interfejsu może mieć tylko jedną z tych przeglądarek: set
, set
, set
, set
lub set
.
Parametr Action
musi określać funkcję wywołania zwrotnego, która zwraca obiekt Compose
skonfigurowany za pomocą Compose
.
// ... const action = CardService.newAction().setFunctionName('composeEmailCallback'); CardService.newTextButton() .setText('Compose Email') .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT); // ... function composeEmailCallback(e) { const thread = GmailApp.getThreadById(e.threadId); const draft = thread.createDraftReply('This is a reply'); return CardService.newComposeActionResponseBuilder() .setGmailDraft(draft) .build(); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
action | Action | Obiekt określający działanie, które ma zostać wykonane po kliknięciu tego elementu. |
composed | Composed | Wartość typu enum określająca, czy skomponowany projekt jest samodzielny czy odpowiedź. |
Powrót
Text
– ten obiekt do łańcucha.
set Disabled(disabled)
Określa, czy przycisk jest wyłączony. Wyłączony przycisk jest wyszarzony i nie można go kliknąć.
Parametry
Nazwa | Typ | Opis |
---|---|---|
disabled | Boolean | Stan wyłączony. |
Powrót
Text
– ten obiekt do łańcucha.
set Icon(icon)
Ustawia wstępnie zdefiniowany Icon
do wyświetlania na przycisku. Do zdefiniowania obrazu przycisku należy użyć tej właściwości lub właściwości set
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
icon | Icon | jedną z wstępnie zdefiniowanych wartości Icon . |
Powrót
Text
– ten obiekt do łańcucha.
set Icon Url(url)
Ustawia adres URL obrazu, który ma być używany jako ikona tego przycisku. Aby zdefiniować obraz przycisku, musisz użyć tej właściwości lub właściwości set
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL hostowanego obrazu, który ma być używany jako ikona tego przycisku. |
Powrót
Text
– ten obiekt do łańcucha.
set Material Icon(icon)
Umożliwia skonfigurowanie ikony w ramach projektu Material Design.
const textButton = CardService.newTextButton().setMaterialIcon( CardService.newMaterialIcon().setName('search'), );
Parametry
Nazwa | Typ | Opis |
---|---|---|
icon | Material | Ikona w stylu Material Design. |
Powrót
Text
– ten obiekt do łańcucha.
set On Click Action(action)
Określa działanie, które jest wykonywane po kliknięciu obiektu. Obiekt interfejsu może mieć tylko jeden z tych parametrów: set
, set
, set
, set
lub set
.
Parametr Action
musi określać funkcję wywołania zwrotnego, która zwraca obiekt Action
.
// ... const action = CardService.newAction().setFunctionName('notificationCallback'); CardService.newTextButton() .setText('Create notification') .setOnClickAction(action); // ... function notificationCallback() { return CardService.newActionResponseBuilder() .setNotification( CardService.newNotification().setText('Some info to display to user'), ) .build(); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
action | Action | Działanie, które ma być wykonywane po kliknięciu tego elementu. |
Powrót
Text
– ten obiekt do łańcucha.
set On Click Open Link Action(action)
Ustawia działanie, które otwiera URL w karcie po kliknięciu obiektu. Użyj tej funkcji, gdy musisz utworzyć adres URL lub gdy oprócz utworzenia obiektu Open
musisz wykonać inne czynności. Obiekt interfejsu może mieć tylko jeden z tych parametrów: set
, set
, set
, set
lub set
.
Parametr Action
musi określać funkcję wywołania zwrotnego, która zwraca obiekt Action
skonfigurowany za pomocą Action
.
// ... const action = CardService.newAction().setFunctionName('openLinkCallback'); CardService.newTextButton() .setText('Open Link') .setOnClickOpenLinkAction(action); // ... function openLinkCallback() { return CardService.newActionResponseBuilder() .setOpenLink(CardService.newOpenLink().setUrl('https://www.google.com')) .build(); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
action | Action | Obiekt określający działanie polegające na otwarciu linku, które ma zostać wykonane po kliknięciu tego elementu. |
Powrót
Text
– ten obiekt do łańcucha.
set Open Link(openLink)
Ustawia adres URL, który zostanie otwarty po kliknięciu obiektu. Użyj tej funkcji, gdy adres URL jest już znany i trzeba go tylko otworzyć. Obiekt interfejsu może mieć tylko jeden z tych parametrów: set
, set
, set
, set
lub set
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
open | Open | Obiekt Open opisujący adres URL do otwarcia. |
Powrót
Text
– ten obiekt do łańcucha.
set Overflow Menu(menu)
Ustawia menu, które otwiera się po kliknięciu obiektu. Każdy element w menu może określać działanie, które zostanie wykonane po kliknięciu. Zagnieżdżone menu nie są obsługiwane, a czynności dotyczące pozycji menu nie powinny określać menu przepełnienia.
Dostępne tylko w przypadku aplikacji Google Chat. Niedostępne w przypadku dodatków Google Workspace.
const overflowMenuItem = CardService.newOverflowMenuItem() .setStartIcon( CardService.newIconImage().setIconUrl( 'https://www.google.com/images/branding/googleg/1x/googleg_standard_color_64dp.png', ), ) .setText('Open Link') .setOpenLink( CardService.newOpenLink().setUrl('https://www.google.com')); const overflowMenu = CardService.newOverflowMenu().addMenuItem(overflowMenuItem).build();
Parametry
Nazwa | Typ | Opis |
---|---|---|
menu | Overflow | Obiekt określający menu przepełnienia do wyświetlenia po kliknięciu tego elementu. |
Powrót
Text
– ten obiekt do łańcucha.
set Text(text)
Określa tekst wyświetlany na przycisku.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst widoczny na przycisku. |
Powrót
Text
– ten obiekt do łańcucha.
set Text Button Style(textButtonStyle)
Ustawia styl przycisku. Jeśli nie jest ustawiony, domyślnie jest używany przycisk Text
.
const button = CardService.newTextButton() .setText('Filled') .setTextButtonStyle(CardService.TextButtonStyle.FILLED) .setOpenLink(CardService.newOpenLink().setUrl('www.google.com'));
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | Text | Styl przycisku. |
Powrót
Text
– ten obiekt do łańcucha.