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). إذا كان وضع "التعاون في التسويق" مفعّلاً في أحد الروابط، لا يمكن للإضافات رصد حالة النافذة، ولا يتم تعديل بطاقة الإضافة.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
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: هذا العنصر، لإنشاء سلسلة.