تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class 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

المعلمات

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

الإرجاع

OpenLink — هذا العنصر، للتسلسل.

`setOpenAs(openAs)`

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

المعلمات

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

الإرجاع

OpenLink — هذا العنصر، للتسلسل.

`setUrl(url)`

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

المعلمات

الاسم	النوع	الوصف
`url`	`String`	عنوان URL المطلوب فتحه.

الإرجاع

OpenLink — هذا العنصر، للتسلسل.