يمثّل إجراءً لفتح رابط مع بعض الخيارات.
تتوفّر هذه الميزة لإضافات 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). إذا كان وضع "التعاون في التسويق" مفعّلاً في أحد الروابط، لا يمكن للإضافات رصد حالة النافذة، ولا يتم تعديل بطاقة الإضافة.
الطُرق
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
|---|---|---|
set | Open | لضبط سلوك إجراء عنوان URL عند إغلاق نافذة أو علامة تبويب عنوان URL |
set | Open | تُستخدَم لضبط سلوك عنوان URL عند فتحه. |
set | Open | تُستخدَم لضبط عنوان URL المطلوب فتحه. |
مستندات تفصيلية
set
set
set
تُستخدَم لضبط عنوان URL المطلوب فتحه. يجب أن يتطابق عنوان URL مع بادئة مدرَجة في القائمة البيضاء في البيان.
المعلَمات
| الاسم | النوع | الوصف |
|---|---|---|
url | String | عنوان URL المطلوب فتحه |
الإرجاع
Open: هذا العنصر، لإنشاء سلسلة.