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: هذا الكائن، للتسلسل.