Class OpenLink

پیوند را باز کنید

نشان دهنده عملی برای باز کردن یک لینک با برخی گزینه‌ها است.

برای افزونه‌های 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 در یک لینک فعال باشد، افزونه‌ها نمی‌توانند وضعیت پنجره را تشخیص دهند و کارت افزونه به‌روزرسانی نمی‌شود.

روش‌ها

روش نوع بازگشتی شرح مختصر
set On Close(onClose) Open Link رفتار اکشن URL را هنگام بسته شدن پنجره یا تب URL تنظیم می‌کند.
set Open As(openAs) Open Link رفتار URL را هنگام باز شدن تنظیم می‌کند.
set Url(url) Open Link آدرس اینترنتی (URL) مورد نظر برای باز شدن را تنظیم می‌کند.

مستندات دقیق

set On Close(onClose)

رفتار اکشن URL را هنگام بسته شدن پنجره یا تب URL تنظیم می‌کند.

پارامترها

نام نوع توضیحات
on Close On Close تنظیمات پایانی.

بازگشت

Open Link - این شیء پیوند باز، برای زنجیره‌سازی.

set Open As(openAs)

رفتار URL را هنگام باز شدن تنظیم می‌کند.

پارامترها

نام نوع توضیحات
open As Open As تنظیمات افتتاحیه.

بازگشت

Open Link - این شیء پیوند باز، برای زنجیره‌سازی.

set Url(url)

URL مورد نظر برای باز شدن را تنظیم می‌کند. URL باید با پیشوندی که در مانیفست ذکر شده است، مطابقت داشته باشد.

پارامترها

نام نوع توضیحات
url String آدرس اینترنتی (URL) مقصد برای باز کردن.

بازگشت

Open Link - این شیء پیوند باز، برای زنجیره‌سازی.