Class Grid

그리드

그리드 항목 모음을 표시하는 정리된 그리드

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

var grid = CardService.newGrid()
    .setTitle("My Grid")
    .setNumColumns(2)
    .addItem(CardService.newGridItem()
        .setTitle("My item"));

방법

메서드반환 유형간략한 설명
addItem(gridItem)Grid그리드에 새 그리드 항목을 추가합니다.
setAuthorizationAction(action)Grid객체를 클릭하면 승인 흐름의 URL을 여는 승인 작업을 설정합니다.
setBorderStyle(borderStyle)Grid각 그리드 항목에 적용되는 테두리 스타일을 설정합니다.
setComposeAction(action, composedEmailType)Grid객체를 클릭하면 초안 이메일을 작성하는 작업을 설정합니다.
setNumColumns(numColumns)Grid그리드에 표시할 열의 개수입니다.
setOnClickAction(action)Grid객체를 클릭할 때 실행되는 작업을 설정합니다.
setOnClickOpenLinkAction(action)Grid객체를 클릭하면 탭에서 URL을 여는 작업을 설정합니다.
setOpenLink(openLink)Grid객체를 클릭하면 열릴 URL을 설정합니다.
setTitle(title)Grid그리드의 제목 텍스트를 설정합니다.

자세한 문서

addItem(gridItem)

그리드에 새 그리드 항목을 추가합니다.

매개변수

이름유형설명
gridItemGridItem추가할 그리드 항목입니다.

리턴

Grid: 체이닝용 객체입니다.


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

매개변수

이름유형설명
actionAuthorizationAction이 요소를 클릭할 때 실행할 승인 작업을 지정하는 객체입니다.

리턴

Grid: 체이닝용 객체입니다.


setBorderStyle(borderStyle)

각 그리드 항목에 적용되는 테두리 스타일을 설정합니다. 기본값은 NO_BORDER입니다.

매개변수

이름유형설명
borderStyleBorderStyle적용할 테두리 스타일입니다.

리턴

Grid: 체이닝용 객체입니다.


setComposeAction(action, composedEmailType)

객체를 클릭하면 초안 이메일을 작성하는 작업을 설정합니다. UI 객체에는 setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) 또는 setComposeAction(action, composedEmailType) 중 하나만 설정할 수 있습니다.

Action 매개변수는 ComposeActionResponseBuilder.setGmailDraft(draft)를 사용하여 구성된 ComposeActionResponse 객체를 반환하는 콜백 함수를 지정해야 합니다.

// ...

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

매개변수

이름유형설명
actionAction이 요소를 클릭할 때 실행할 작성 작업을 지정하는 객체입니다.
composedEmailTypeComposedEmailType작성된 초안이 독립형인지 답장 초안인지 지정하는 열거형 값입니다.

리턴

Grid: 체이닝용 객체입니다.


setNumColumns(numColumns)

그리드에 표시할 열의 개수입니다. 오른쪽 패널에 표시된 경우 1~2개의 열을 표시할 수 있으며 기본값은 1입니다. 대화상자에 표시된 경우 2~3개의 열을 표시할 수 있으며 기본값은 2입니다.

매개변수

이름유형설명
numColumnsInteger열의 개수입니다.

리턴

Grid: 체이닝용 객체입니다.


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

매개변수

이름유형설명
actionAction이 요소를 클릭하면 수행할 작업입니다.

리턴

Grid: 체이닝용 객체입니다.


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

매개변수

이름유형설명
actionAction이 요소를 클릭할 때 실행할 링크 열기 작업을 지정하는 객체입니다.

리턴

Grid: 체이닝용 객체입니다.


객체를 클릭하면 열릴 URL을 설정합니다. URL이 이미 알려져 있고 URL을 열어야 하는 경우 이 함수를 사용합니다. UI 객체에는 setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) 또는 setComposeAction(action, composedEmailType) 중 하나만 설정할 수 있습니다.

매개변수

이름유형설명
openLinkOpenLink열려는 URL을 설명하는 OpenLink 객체입니다.

리턴

Grid: 체이닝용 객체입니다.


setTitle(title)

그리드의 제목 텍스트를 설정합니다. 텍스트는 서식이 없는 일반 문자열이어야 합니다.

매개변수

이름유형설명
titleString제목 텍스트입니다.

리턴

Grid: 체이닝용 객체입니다.