Class Image

이미지

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

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

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이 이미지에 할당할 대체 텍스트입니다.

리턴

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이 요소가 설정될 때 수행할 승인 작업을 지정하는 객체입니다. 있습니다.

리턴

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


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

매개변수

이름유형설명
actionAction이 요소가 설정되었을 때 실행할 작성 작업을 지정하는 객체입니다. 있습니다.
composedEmailTypeComposedEmailType작성된 초안이 답장 초안을 작성할 수 있습니다

리턴

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 주소 또는 인코딩된 이미지 문자열입니다.

리턴

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

리턴

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

리턴

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


객체를 클릭할 때 열 URL을 설정합니다. URL이 열려있기만 하면 됩니다. 하나의 UI 객체에는 setOpenLink(openLink) 중 하나만 있을 수 있습니다. setOnClickAction(action)님, setOnClickOpenLinkAction(action)님, setAuthorizationAction(action)님 또는 setComposeAction(action, composedEmailType)가 설정됩니다.

매개변수

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

리턴

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