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 מופעל בקישור, התוספים לא יכולים לזהות את מצב החלון וכרטיס התוסף לא מתעדכן.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
setOnClose(onClose)	OpenLink	הגדרת ההתנהגות של פעולת כתובת ה-URL כשחלון כתובת ה-URL או הכרטיסייה סגורים.
setOpenAs(openAs)	OpenLink	הגדרת ההתנהגות של כתובת ה-URL כשהיא נפתחת.
setUrl(url)	OpenLink	הגדרת כתובת ה-URL שרוצים לפתוח.

מסמכים מפורטים

setOnClose(onClose)

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

פרמטרים

שם	סוג	תיאור
onClose	OnClose	ההגדרה של הסגירה.

חזרה

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

---

setOpenAs(openAs)

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

פרמטרים

שם	סוג	תיאור
openAs	OpenAs	ההגדרה של פתיחת הקישור.

חזרה

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

---

setUrl(url)

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

פרמטרים

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

חזרה

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