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 – האובייקט הזה, לשרשור.