OnClick

• نمایش JSON
• OpenLink
  • نمایش JSON
• OpenAs
• OnClose
• OverflowMenu
  • نمایش JSON
• OverflowMenuItem
  • نمایش JSON

نشان‌دهنده نحوه پاسخ دادن به کلیک کاربر روی عنصر تعاملی در کارت، مثل دکمه، است.

برای برنامه‌های Google Chat و برافزاهای Google Workspace دردسترس است.

نمایش JSON
{ "action": { object (Action) }, "openLink": { object (OpenLink) }, "openDynamicLinkAction": { object (Action) }, "card": { object (Card) }, "overflowMenu": { object (OverflowMenu) } }

فیلدها
در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
action	object (Action) اگر مشخص شده باشد، کنشی توسط این onClick راه‌اندازی می‌شود.
openLink	object (OpenLink) اگر مشخص شده باشد، این onClick کنش پیوند باز را راه‌اندازی می‌کند.
openDynamicLinkAction	object (Action) وقتی کنش نیاز به باز کردن پیوند داشته باشد، برافزا این کنش را راه‌اندازی می‌کند. این با openLink بالا متفاوت است زیرا برای دریافت پیوند باید با سرور ارتباط برقرار کند. بنابراین، قبل‌از اینکه پاسخ کنش پیوند باز برگردد، مشتری وب باید کارهای آماده‌سازی را انجام دهد. برای برافزاهای Google Workspace دردسترس است و برای برنامه‌های Google Chat دردسترس نیست.
card	object (Card) درصورت مشخص شدن، پس‌از کلیک کردن، کارت جدیدی به دسته کارت‌ها اضافه می‌شود. برای برافزاهای Google Workspace دردسترس است و برای برنامه‌های Google Chat دردسترس نیست.
overflowMenu	object (OverflowMenu) اگر مشخص شده باشد، این onClick منوِ سرریز را باز می‌کند.
پایان فیلدهای متقابلاً انحصاری.

OpenLink

نشان‌دهنده رویداد onClick است که اَبَرپیوندی را باز می‌کند.

برای برنامه‌های Google Chat و برافزاهای Google Workspace دردسترس است.

نمایش JSON
{ "url": string, "openAs": enum (OpenAs), "onClose": enum (OnClose) }

فیلدها
url	string نشانی وب برای باز کردن. نشانی‌های وب HTTP به HTTPS تبدیل می‌شوند.
openAs	enum (OpenAs) نحوه باز کردن پیوند. برای برافزاهای Google Workspace دردسترس است و برای برنامه‌های Google Chat دردسترس نیست.
onClose	enum (OnClose) اینکه آیا کارخواه پس‌از باز کردن پیوند آن را فراموش می‌کند یا تا بسته شدن پنجره آن را مشاهده می‌کند. برای برافزاهای Google Workspace دردسترس است و برای برنامه‌های Google Chat دردسترس نیست.

OpenAs

وقتی کنش OnClick پیوندی را باز می‌کند، کارخواه می‌تواند آن را به‌صورت پنجره تمام‌اندازه (اگر قاب مورداستفاده کارخواه باشد) یا هم‌پوشانی (مثل بالاپر) باز کند. پیاده‌سازی به قابلیت‌های پلاتفرم کارخواه بستگی دارد و اگر کارخواه از مقدار انتخاب‌شده پشتیبانی نکند، ممکن است این مقدار نادیده گرفته شود. FULL_SIZE توسط همه کلاینت‌ها پشتیبانی می‌شود.

برای برافزاهای Google Workspace دردسترس است و برای برنامه‌های Google Chat دردسترس نیست.

شمارشی‌ها
FULL_SIZE	پیوند به‌صورت پنجره‌ای با اندازه کامل باز می‌شود (اگر این قاب مورداستفاده کارخواه باشد).
OVERLAY	پیوند به‌صورت هم‌پوشانی، مثلاً بالاپر، باز می‌شود.

OnClose

وقتی پیوندی که با کنش OnClick باز شده است بسته می‌شود، کلاینت چه کاری انجام می‌دهد.

پیاده‌سازی به قابلیت‌های پلاتفرم کارخواه بستگی دارد. برای مثال، مرورگر وب ممکن است پیوندی را در پنجره بالاپر با گرداننده OnClose باز کند.

اگر هر دو گرداننده OnOpen و OnClose تنظیم شده باشند و پلاتفرم کارخواه نتواند از هر دو مقدار پشتیبانی کند، OnClose اولویت دارد.

برای برافزاهای Google Workspace دردسترس است و برای برنامه‌های Google Chat دردسترس نیست.

شمارشی‌ها
NOTHING	مقدار پیش‌فرض. کارت بارگیری مجدد نمی‌شود؛ اتفاقی نمی‌افتد.
RELOAD	کارت را پس‌از بسته شدن پنجره فرزند مجدداً بار می‌کند. اگر در ترکیب با OpenAs.OVERLAY استفاده شود، پنجره فرزند به‌عنوان کادر گفتگوی مدال عمل می‌کند و کارت ولی تا زمانی که پنجره فرزند بسته نشود مسدود می‌شود.

OverflowMenu

ابزارکی که منوی بالاپری با یک یا چند کنش ارائه می‌دهد که کاربران می‌توانند آن‌ها را فراخوانی کنند. برای مثال، نمایش کنش‌های غیر اصلی در کارت. وقتی کنش‌ها در فضای دردسترس جا نمی‌شوند، می‌توانید از این ابزاره استفاده کنید. برای استفاده، این ابزاره را در کنش OnClick ابزاره‌هایی که از آن پشتیبانی می‌کنند مشخص کنید. برای مثال، در Button.

برای برنامه‌های Google Chat و برافزاهای Google Workspace دردسترس است.

نمایش JSON
{ "items": [ { object (OverflowMenuItem) } ] }

فیلدها
items[]	object (OverflowMenuItem) الزامی. فهرست گزینه‌های منو.

OverflowMenuItem

گزینه‌ای که کاربران می‌توانند در منوِ سرریز فراخوانی کنند.

برای برنامه‌های Google Chat و برافزاهای Google Workspace دردسترس است.

نمایش JSON
{ "startIcon": { object (Icon) }, "text": string, "onClick": { object (OnClick) }, "disabled": boolean }

فیلدها
startIcon	object (Icon) نمادی که جلوی نوشتار نمایش داده می‌شود.
text	string الزامی. نوشتاری که مورد را برای کاربران شناسایی یا توصیف می‌کند.
onClick	object (OnClick) الزامی. کنشی که هنگام انتخاب گزینه منو فراخوانده می‌شود. این OnClick نمی‌تواند حاوی OverflowMenu باشد، هر OverflowMenu مشخص‌شده‌ای حذف می‌شود و گزینه منو غیرفعال می‌شود.
disabled	boolean آیا گزینه منو غیرفعال است. پیش‌فرض: نادرست.