Class Image

이미지

단일 이미지를 표시하는 위젯 이미지 자르기에 관한 자세한 내용은 ImageCropStyle를 참고하세요.

var image = CardService.newImage().setAltText("A nice image").setImageUrl("https://image.png");

방법

메서드반환 유형간략한 설명
setAltText(altText)Image접근성을 위해 이미지의 대체 텍스트를 설정합니다.
setAuthorizationAction(action)Image객체 클릭 시 승인 흐름의 URL을 여는 승인 작업을 설정합니다.
setComposeAction(action, composedEmailType)Image객체 클릭 시 이메일 초안을 작성하는 작업을 설정합니다.
setImageUrl(url)ImageURL 또는 데이터 문자열을 제공하여 사용할 이미지를 설정합니다.
setOnClickAction(action)Image객체를 클릭할 때 실행되는 작업을 설정합니다.
setOnClickOpenLinkAction(action)Image객체 클릭 시 탭에서 URL을 여는 작업을 설정합니다.
setOpenLink(openLink)Image객체를 클릭하면 열리는 URL을 설정합니다.

자세한 문서

setAltText(altText)

접근성을 위해 이미지의 대체 텍스트를 설정합니다. 필수 항목입니다.

매개변수

이름유형설명
altTextString이 이미지에 할당할 대체 텍스트입니다.

Return 키

Image - 체인을 위한 객체입니다.


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이 요소를 클릭할 때 실행할 승인 작업을 지정하는 객체입니다.

Return 키

Image - 체인을 위한 객체입니다.


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구성된 초안이 독립형인지 답장 초안인지 지정하는 enum 값입니다.

Return 키

Image - 체인을 위한 객체입니다.


setImageUrl(url)

URL 또는 데이터 문자열을 제공하여 사용할 이미지를 설정합니다. 필수 항목입니다.

제공된 URL은 공개적으로 액세스할 수 있는 URL이거나 base64로 인코딩된 이미지 문자열일 수 있습니다. 다음 코드를 사용하여 Google Drive의 이미지에서 인코딩된 이미지 문자열을 만든 후 나중에 사용할 수 있도록 setImageUrl(url)에 저장하면 됩니다. 이 메서드를 사용하면 부가기능이 공개적으로 사용 가능한 이미지 URL에 액세스할 필요가 없습니다.

// The following assumes you have the image to use in Google Drive and have its ID.
var imageBytes = DriveApp.getFileById(imageID).getBlob().getBytes();
var encodedImageURL = "data:image/jpeg;base64," + Utilities.base64Encode(imageBytes);

// You can store encodeImageURL and use it as a parameter to Image.setImageUrl(url).

매개변수

이름유형설명
urlString사용할 호스팅된 이미지의 URL 주소 또는 인코딩된 이미지 문자열입니다.

Return 키

Image - 체인을 위한 객체입니다.


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

Return 키

Image - 체인을 위한 객체입니다.


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이 요소를 클릭했을 때 실행할 열린 링크 작업을 지정하는 객체입니다.

Return 키

Image - 체인을 위한 객체입니다.


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

매개변수

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

Return 키

Image - 체인을 위한 객체입니다.