선택적 장식이 있는 텍스트를 표시하는 위젯입니다. 가능한 키는 아이콘, 위의 라벨, 아래의 라벨을 포함합니다. setText(text)
및 DecoratedText
, DecoratedText
, setTopLabel(text)
, setBottomLabel(text)
중 하나를 사용하여 텍스트 콘텐츠와 키 중 하나를 설정해야 합니다. 이 클래스는
를 대체하기 위한 것입니다.
KeyValue
Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.
const decoratedText = CardService.newDecoratedText().setText('Text').setTopLabel('TopLabel'); const multilineDecoratedText = CardService.newDecoratedText() .setText('Text') .setTopLabel('TopLabel') .setWrapText(true) .setBottomLabel('BottomLabel');
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
setAuthorizationAction(action) | DecoratedText | 객체를 클릭할 때 승인 흐름으로 연결되는 URL을 여는 승인 작업을 설정합니다. |
setBottomLabel(text) | DecoratedText | 키로 사용되며 텍스트 콘텐츠 아래에 표시되는 라벨 텍스트를 설정합니다. |
setButton(button) | DecoratedText | 텍스트 오른쪽에 표시되는 Button 를 설정합니다. |
setComposeAction(action, composedEmailType) | DecoratedText | 객체를 클릭하면 초안 이메일을 작성하는 작업을 설정합니다. |
setEndIcon(endIcon) | DecoratedText | 콘텐츠 오른쪽에 표시되는 IconImage (선택사항)를 설정합니다. |
setOnClickAction(action) | DecoratedText | 객체가 클릭될 때 실행되는 작업을 설정합니다. |
setOnClickOpenLinkAction(action) | DecoratedText | 객체를 클릭할 때 탭에서 URL을 여는 작업을 설정합니다. |
setOpenLink(openLink) | DecoratedText | 객체를 클릭할 때 열릴 URL을 설정합니다. |
setStartIcon(startIcon) | DecoratedText | 텍스트 콘텐츠 앞에 표시할 선택적 IconImage 를 설정합니다. |
setSwitchControl(switchToSet) | DecoratedText | 콘텐츠 오른쪽에 표시되는 Switch 를 설정합니다. |
setText(text) | DecoratedText | 값으로 사용할 텍스트를 설정합니다. |
setTopLabel(text) | DecoratedText | 키로 사용되며 텍스트 콘텐츠 위에 표시되는 라벨 텍스트를 설정합니다. |
setWrapText(wrapText) | DecoratedText | 값 텍스트를 한 줄에 표시할지 아니면 여러 줄에 표시할지를 설정합니다. |
자세한 문서
setAuthorizationAction(action)
객체를 클릭할 때 승인 흐름으로 연결되는 URL을 여는 승인 작업을 설정합니다. 그러면 URL이 새 창에서 열립니다. 사용자가 승인 흐름을 완료하고 애플리케이션으로 돌아오면 부가기능이 새로고침됩니다.
UI 객체는 setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
또는 setComposeAction(action, composedEmailType)
중 하나만 설정할 수 있습니다.
// ... const action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
매개변수
이름 | 유형 | 설명 |
---|---|---|
action | AuthorizationAction | 이 요소가 클릭될 때 취할 승인 작업을 지정하는 객체입니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setBottomLabel(text)
키로 사용되며 텍스트 콘텐츠 아래에 표시되는 라벨 텍스트를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 라벨 텍스트입니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setButton(button)
텍스트 오른쪽에 표시되는 Button
를 설정합니다. DecoratedText
는 버튼이나 스위치를 하나만 지원할 수 있습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
button | Button | 추가할 버튼입니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setComposeAction(action, composedEmailType)
객체를 클릭하면 초안 이메일을 작성하는 작업을 설정합니다. UI 객체에는 setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
, setComposeAction(action, composedEmailType)
중 하나만 설정할 수 있습니다.
Action
매개변수는 ComposeActionResponseBuilder.setGmailDraft(draft)
를 사용하여 구성된 ComposeActionResponse
객체를 반환하는 콜백 함수를 지정해야 합니다.
// ... const action = CardService.newAction().setFunctionName('composeEmailCallback'); CardService.newTextButton() .setText('Compose Email') .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT); // ... function composeEmailCallback() { const thread = GmailApp.getThreadById(e.threadId); const draft = thread.createDraftReply('This is a reply'); return CardService.newComposeActionResponseBuilder() .setGmailDraft(draft) .build(); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
action | Action | 이 요소를 클릭할 때 실행할 작성 작업을 지정하는 객체입니다. |
composedEmailType | ComposedEmailType | 작성된 초안이 독립형 초안인지 답장 초안인지 지정하는 enum 값입니다. |
리턴
DecoratedText
- 체이닝을 위한 객체입니다.
setEndIcon(endIcon)
콘텐츠 오른쪽에 표시되는 선택적 IconImage
를 설정합니다. DecoratedText
는 버튼 1개, 스위치 1개 또는 아이콘 1개만 지원할 수 있습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
endIcon | IconImage | 추가할 아이콘 |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setOnClickAction(action)
객체가 클릭될 때 실행되는 작업을 설정합니다. UI 객체는 setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
또는 setComposeAction(action, composedEmailType)
중 하나만 설정할 수 있습니다.
Action
매개변수는 ActionResponse
객체를 반환하는 콜백 함수를 지정해야 합니다.
// ... 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(); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
action | Action | 이 요소를 클릭하면 수행할 작업입니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setOnClickOpenLinkAction(action)
객체를 클릭하면 탭에서 URL을 여는 작업을 설정합니다. URL을 빌드해야 하거나 OpenLink
객체를 만드는 것 외에도 다른 작업을 실행해야 하는 경우 이 함수를 사용하세요. UI 객체는 setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
또는 setComposeAction(action, composedEmailType)
중 하나만 설정할 수 있습니다.
Action
매개변수는 ActionResponseBuilder.setOpenLink(openLink)
를 사용하여 구성된 ActionResponse
객체를 반환하는 콜백 함수를 지정해야 합니다.
// ... 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(); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
action | Action | 이 요소가 클릭될 때 실행할 링크 열기 작업을 지정하는 객체입니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setOpenLink(openLink)
객체를 클릭할 때 열 URL을 설정합니다. URL이 이미 알려져 있고 열기만 하면 되는 경우에 이 함수를 사용하세요. UI 객체에는 setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
, setComposeAction(action, composedEmailType)
중 하나만 설정할 수 있습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
openLink | OpenLink | 열려는 URL을 설명하는 OpenLink 객체입니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setStartIcon(startIcon)
텍스트 콘텐츠 앞에 표시할 IconImage
(선택사항)를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
startIcon | IconImage | 표시할 아이콘입니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setSwitchControl(switchToSet)
콘텐츠 오른쪽에 표시되는 Switch
를 설정합니다. DecoratedText
는 버튼이나 스위치를 하나만 지원할 수 있습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
switchToSet | Switch | 추가할 스위치입니다. |
리턴
DecoratedText
- 체이닝을 위한 객체입니다.
setText(text)
값으로 사용할 텍스트를 설정합니다. 기본 HTML 형식을 지원합니다. 필수 항목입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 이 위젯의 텍스트 콘텐츠입니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setTopLabel(text)
키로 사용될 라벨 텍스트를 설정하며 텍스트 콘텐츠 위에 표시됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 라벨 텍스트입니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.
setWrapText(wrapText)
값 텍스트를 한 줄에 표시할지 여러 줄에 표시할지 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
wrapText | Boolean | true 인 경우 텍스트가 여러 줄로 줄바꿈되어 표시됩니다. 그렇지 않으면 텍스트가 잘립니다. |
리턴
DecoratedText
: 연결을 위한 객체입니다.