이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class DecoratedText

선택적 장식이 있는 텍스트를 표시하는 위젯입니다. 가능한 키는 아이콘, 위의 라벨, 아래의 라벨을 포함합니다. 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 객체를 반환하는 콜백 함수를 지정해야 합니다.

참고: 이 메서드는 Compose UI를 확장하는 데 사용되는 Compose 작업을 설정하지 않습니다. 이 메서드는 이 UI 요소를 Apps Script에서 메일 초안을 작성하고 작업이 완료되면 Gmail에서 열리는 Action에 연결합니다.

// ...

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();
}

매개변수

이름	유형	설명
`action`	`Action`	이 요소가 클릭될 때 실행할 작성 작업을 지정하는 객체입니다.
`composedEmailType`	`ComposedEmailType`	작성된 초안이 독립형 초안인지 답장 초안인지 지정하는 enum 값입니다.

리턴

DecoratedText: 연결을 위한 객체입니다.

`setEndIcon(endIcon)`

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

매개변수

이름	유형	설명
`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: 연결을 위한 객체입니다.