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

روش‌ها

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

مستندات دقیق

setOnClose(onClose)

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

پارامترها

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

بازگشت

OpenLink — این شیء، برای زنجیره‌سازی.

setOpenAs(openAs)

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

پارامترها

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

بازگشت

OpenLink — این شیء، برای زنجیره‌سازی.

setUrl(url)

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

پارامترها

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

بازگشت

OpenLink — این شیء، برای زنجیره‌سازی.