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