이미지가 표시된 ImageButton
Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.
var imageButton = CardService.newImageButton() .setAltText("An image button with an airplane icon.") .setIcon(CardService.Icon.AIRPLANE) .setOpenLink(CardService.newOpenLink() .setUrl("https://airplane.com"));
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
setAltText(altText) | ImageButton | 접근성을 위한 버튼의 대체 텍스트를 설정합니다. |
setAuthorizationAction(action) | ImageButton | 객체가 다음 상태일 때 승인 흐름으로 연결되는 URL을 여는 승인 작업을 설정합니다. 있습니다. |
setComposeAction(action, composedEmailType) | ImageButton | 객체를 클릭하면 초안 이메일을 작성하는 작업을 설정합니다. |
setIcon(icon) | ImageButton | 버튼에 표시할 사전 정의된 Icon 를 설정합니다. |
setIconUrl(url) | ImageButton | 이 버튼의 아이콘으로 사용할 이미지의 URL을 설정합니다. |
setOnClickAction(action) | ImageButton | 객체를 클릭할 때 실행되는 작업을 설정합니다. |
setOnClickOpenLinkAction(action) | ImageButton | 객체를 클릭하면 탭에서 URL을 여는 작업을 설정합니다. |
setOpenLink(openLink) | ImageButton | 객체를 클릭할 때 열 URL을 설정합니다. |
자세한 문서
setAltText(altText)
접근성을 위한 버튼의 대체 텍스트를 설정합니다. 필수 항목입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
altText | String | 이 버튼에 할당할 대체 텍스트입니다. |
리턴
ImageButton
- 체이닝을 위한 객체입니다.
setAuthorizationAction(action)
객체가 다음 상태일 때 승인 흐름으로 연결되는 URL을 여는 승인 작업을 설정합니다. 있습니다. 그러면 새 창에서 URL이 열립니다. 사용자가 승인 흐름을 완료하고 애플리케이션으로 돌아가면 부가기능이 새로고침됩니다.
UI 객체에는 setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
, setComposeAction(action, composedEmailType)
중 하나만 설정할 수 있습니다.
// ... var action = CardService.newAuthorizationAction().setAuthorizationUrl('url'); CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);
매개변수
이름 | 유형 | 설명 |
---|---|---|
action | AuthorizationAction | 이 요소가 설정될 때 수행할 승인 작업을 지정하는 객체입니다. 있습니다. |
리턴
ImageButton
- 체이닝을 위한 객체입니다.
setComposeAction(action, composedEmailType)
객체를 클릭하면 초안 이메일을 작성하는 작업을 설정합니다. UI 객체는
setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
,
setAuthorizationAction(action)
또는 setComposeAction(action, composedEmailType)
가 설정되었습니다.
Action
매개변수는 ComposeActionResponseBuilder.setGmailDraft(draft)
를 사용하여 구성된 ComposeActionResponse
객체를 반환하는 콜백 함수를 지정해야 합니다.
<ph type="x-smartling-placeholder">
// ... var action = CardService.newAction().setFunctionName('composeEmailCallback'); CardService.newTextButton() .setText('Compose Email') .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT); // ... function composeEmailCallback() { var thread = GmailApp.getThreadById(e.threadId); var draft = thread.createDraftReply('This is a reply'); return CardService.newComposeActionResponseBuilder() .setGmailDraft(draft) .build(); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
action | Action | 이 요소가 설정되었을 때 실행할 작성 작업을 지정하는 객체입니다. 있습니다. |
composedEmailType | ComposedEmailType | 작성된 초안이 답장 초안을 작성할 수 있습니다 |
리턴
ImageButton
- 체이닝을 위한 객체입니다.
setIcon(icon)
버튼에 표시할 사전 정의된 Icon
를 설정합니다. 이 항목 또는 setIconUrl(url)
버튼 이미지를 정의하는 데 사용해야 합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
icon | Icon | 사전 정의된 Icon 값 중 하나입니다. |
리턴
ImageButton
- 체이닝을 위한 객체입니다.
setIconUrl(url)
이 버튼의 아이콘으로 사용할 이미지의 URL을 설정합니다. 이 속성 또는 setIcon(icon)
가 다음과 같아야 합니다.
버튼 이미지를 정의하는 데 사용됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
url | String | 이 버튼의 아이콘으로 사용할 호스팅된 이미지의 URL 주소입니다. |
리턴
ImageButton
- 체이닝을 위한 객체입니다.
setOnClickAction(action)
객체를 클릭할 때 실행되는 작업을 설정합니다. UI 객체는
setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
또는 setComposeAction(action, composedEmailType)
가 설정되었습니다.
Action
매개변수는 ActionResponse
객체를 반환하는 콜백 함수를 지정해야 합니다.
// ... var 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 | 이 요소를 클릭하면 수행할 작업입니다. |
리턴
ImageButton
- 체이닝을 위한 객체입니다.
setOnClickOpenLinkAction(action)
객체를 클릭하면 탭에서 URL을 여는 작업을 설정합니다. 이 함수는
URL을 빌드해야 하거나 OpenLink
객체 생성 외에 다른 작업을 수행해야 하는 경우 UI 객체는 setOpenLink(openLink)
, setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
,
setComposeAction(action, composedEmailType)
설정됨.
Action
매개변수는 ActionResponseBuilder.setOpenLink(openLink)
를 사용하여 구성된 ActionResponse
객체를 반환하는 콜백 함수를 지정해야 합니다.
// ... var 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 | 이 요소가 다음 상태일 때 실행할 링크 열기 작업을 지정하는 객체입니다. 있습니다. |
리턴
ImageButton
- 체이닝을 위한 객체입니다.
setOpenLink(openLink)
객체를 클릭할 때 열 URL을 설정합니다. URL이
열려있기만 하면 됩니다. 하나의 UI 객체에는 setOpenLink(openLink)
중 하나만 있을 수 있습니다.
setOnClickAction(action)
님, setOnClickOpenLinkAction(action)
님, setAuthorizationAction(action)
님
또는 setComposeAction(action, composedEmailType)
가 설정됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
openLink | OpenLink | 열려는 URL을 설명하는 OpenLink 객체입니다. |
리턴
ImageButton
- 체이닝을 위한 객체입니다.