يمثل هذا الخيار إجراءً لفتح رابط مع بعض الخيارات.
// 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();
ملاحظة: لإعادة تحميل الإضافات بعد إغلاق الرابط، لا تستخدم رابطًا تم فيه تفعيل عنوان السياسة (COOP) Cross-Origin-Opener-Policy (COOP). إذا تم تفعيل COOP في رابط، لن تتمكّن الإضافات من رصد حالة النافذة، ولا يتم تعديل بطاقة الإضافة.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
setOnClose(onClose) | OpenLink | تحدِّد هذه السياسة سلوك إجراء عنوان URL عند إغلاق نافذة عنوان URL أو علامة التبويب. |
setOpenAs(openAs) | OpenLink | تحدِّد هذه السياسة سلوك عنوان URL عند فتحه. |
setUrl(url) | OpenLink | لضبط عنوان URL المراد فتحه. |
الوثائق التفصيلية
setOnClose(onClose)
setOpenAs(openAs)
setUrl(url)
لضبط عنوان URL المراد فتحه. يجب أن يتطابق عنوان URL مع بادئة مدرَجة في القائمة البيضاء في البيان.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
url | String | عنوان URL المطلوب فتحه. |
استرجاع الكرة
OpenLink
: هذا الكائن للتسلسل.