Class OpenLink

OpenLink

מייצג פעולה לפתיחת קישור עם כמה אפשרויות.

ההגדרה זמינה לתוספים ל-Google Workspace ולאפליקציות של Google Chat.

// A button that opens as a link in an overlay and
// requires a reload when closed.
var 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.
var 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)OpenLinkהמדיניות הזו מגדירה את ההתנהגות של פעולת כתובת ה-URL כשחלון כתובת ה-URL או הכרטיסייה נסגרים.
setOpenAs(openAs)OpenLinkמגדיר את ההתנהגות של כתובת URL כשהיא נפתחת.
setUrl(url)OpenLinkהגדרת כתובת URL לפתיחה.

מסמכי תיעוד מפורטים

setOnClose(onClose)

המדיניות הזו מגדירה את ההתנהגות של פעולת כתובת ה-URL כשחלון כתובת ה-URL או הכרטיסייה נסגרים.

פרמטרים

שםסוגתיאור
onCloseOnCloseהגדרת הסגירה.

חזרה

OpenLink – האובייקט הזה, לשרשור.


setOpenAs(openAs)

מגדיר את ההתנהגות של כתובת URL כשהיא נפתחת.

פרמטרים

שםסוגתיאור
openAsOpenAsהגדרת הפתיחה.

חזרה

OpenLink – האובייקט הזה, לשרשור.


setUrl(url)

הגדרת כתובת URL לפתיחה. כתובת ה-URL חייבת להתאים לקידומת שמופיעה ברשימת ההיתרים ב- את המניפסט.

פרמטרים

שםסוגתיאור
urlStringכתובת ה-URL לפתיחה.

חזרה

OpenLink – האובייקט הזה, לשרשור.