يمثل هذا الإجراء إجراءً لفتح رابط مع بعض الخيارات.
يتوفّر هذا الخيار لإضافات 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)
setOpenAs(openAs)
setUrl(url)
لضبط عنوان URL المراد فتحه. يجب أن يطابق عنوان URL بادئة مُدرجة في القائمة البيضاء في في البيان.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL المطلوب فتحه. |
الإرجاع
OpenLink
— هذا العنصر، للتسلسل.