Class DecoratedText

DecoratedText

선택적 장식과 함께 텍스트를 표시하는 위젯입니다. 가능한 키로는 아이콘, 라벨이 있습니다. 아래에 라벨이 있습니다. setText(text)와 DecoratedText, DecoratedText, setTopLabel(text), setBottomLabel(text) 중 하나를 사용하여 텍스트 콘텐츠와 키 중 하나를 설정해야 합니다. 이 클래스는 KeyValue를 대체하기 위한 클래스입니다.

Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.

var decoratedText = CardService.newDecoratedText()
    .setText("Text")
    .setTopLabel("TopLabel");

var 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) 중 하나만 설정할 수 있습니다.

// ...

var 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 객체를 반환하는 콜백 함수를 지정해야 합니다.

<ph type="x-smartling-placeholder">

</ph> 참고: 이 메서드는 다음과 같은 작성 작업을 설정하지 않습니다. 작성 UI를 확장하는 데 사용됩니다. 대신 이 메서드는 Apps Script에서 다음과 같은 초안 메시지를 작성하는 Action에 이 UI 요소를 연결합니다. Gmail에서 열립니다.

// ...

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	작성된 초안이 답장 초안을 작성할 수 있습니다

리턴

DecoratedText - 체이닝을 위한 객체입니다.

---

setEndIcon(endIcon)

콘텐츠 오른쪽에 표시되는 IconImage(선택사항)를 설정합니다. DecoratedText은 하나의 버튼, 하나의 스위치 또는 하나의 아이콘만 지원할 수 있습니다.

매개변수

이름	유형	설명
endIcon	IconImage	추가할 아이콘입니다.

리턴

DecoratedText - 체이닝을 위한 객체입니다.

---

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	이 요소를 클릭하면 수행할 작업입니다.

리턴

DecoratedText - 체이닝을 위한 객체입니다.

---

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	이 요소가 다음 상태일 때 실행할 링크 열기 작업을 지정하는 객체입니다. 있습니다.

리턴

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 - 체이닝을 위한 객체입니다.