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)	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: هذا العنصر، للتسلسل