Class OpenLink

فتحالرابط

إصدار تجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.

تمثّل هذه السمة إجراءً لفتح رابط مع بعض الخيارات.

متاحة لإضافات 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 =
    AddOnsResponseService.newActionResponseBuilder()
        .setOpenLink(
            AddOnsResponseService.newOpenLink()
                .setUrl('https://www.google.com')
                .setOpenAs(AddOnsResponseService.OpenAs.FULL_SIZE)
                .setOnClose(AddOnsResponseService.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 أو علامة التبويب.

المعلمات

الاسم	النوع	الوصف
onClose	OnClose	إعداد الإغلاق

الإرجاع

‫OpenLink: عنصر الرابط المفتوح هذا، للسلسلة.

---

setOpenAs(openAs)

تضبط هذه السمة سلوك عنوان URL عند فتحه.

المعلمات

الاسم	النوع	الوصف
openAs	OpenAs	إعدادات الفتح

الإرجاع

‫OpenLink: عنصر الرابط المفتوح هذا، للسلسلة.

---

setUrl(url)

تضبط هذه السمة عنوان URL الذي سيتم فتحه. يجب أن يتطابق عنوان URL مع بادئة مُدرَجة في القائمة البيضاء في ملف البيان.

المعلمات

الاسم	النوع	الوصف
url	String	عنوان URL المقصود الذي سيتم فتحه.

الإرجاع

‫OpenLink: عنصر الرابط المفتوح هذا، للسلسلة.