Class OpenLink

링크 열기

일부 옵션이 있는 링크를 여는 작업을 나타냅니다.

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

// A button that opens as a link in an overlay and
// requires a reload when closed.
const button = CardService.newTextButton()
                   .setText('This button opens a link in an overlay window')
                   .setOpenLink(
                       CardService.newOpenLink()
                           .setUrl('https://www.google.com')
                           .setOpenAs(CardService.OpenAs.OVERLAY)
                           .setOnClose(CardService.OnClose.RELOAD_ADD_ON),
                   );

// An action response that opens a link in full screen and
// requires no action when closed.
const actionResponse = CardService.newActionResponseBuilder()
                           .setOpenLink(
                               CardService.newOpenLink()
                                   .setUrl('https://www.google.com')
                                   .setOpenAs(CardService.OpenAs.FULL_SIZE)
                                   .setOnClose(CardService.OnClose.NOTHING),
                               )
                           .build();

참고: 링크를 닫은 후 부가기능을 새로고침하려면 Cross-Origin-Opener-Policy (COOP) 헤더가 사용 설정된 링크를 사용하지 마세요. 링크에서 COOP가 사용 설정된 경우 부가기능에서 창 상태를 감지할 수 없으며 부가기능 카드가 업데이트되지 않습니다.

메서드

메서드반환 유형간략한 설명
setOnClose(onClose)OpenLinkURL 창 또는 탭이 닫힐 때 URL 작업의 동작을 설정합니다.
setOpenAs(openAs)OpenLinkURL이 열릴 때의 동작을 설정합니다.
setUrl(url)OpenLink열릴 URL을 설정합니다.

자세한 문서

setOnClose(onClose)

URL 창 또는 탭이 닫힐 때 URL 작업의 동작을 설정합니다.

매개변수

이름유형설명
onCloseOnClose종료 설정

리턴

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


setOpenAs(openAs)

URL이 열릴 때의 동작을 설정합니다.

매개변수

이름유형설명
openAsOpenAs시작 설정입니다.

리턴

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


setUrl(url)

열릴 URL을 설정합니다. URL은 매니페스트에 허용 목록에 추가된 접두사와 일치해야 합니다.

매개변수

이름유형설명
urlString열려는 URL입니다.

리턴

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