Package google.apps.card.v1

شاخص

اقدام

اقدامی که رفتار را هنگام ارسال فرم توصیف می کند. به عنوان مثال، می توانید یک اسکریپت Apps Script را برای مدیریت فرم فراخوانی کنید. اگر عمل فعال شود، مقادیر فرم به سرور ارسال می شود.

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

فیلدها
function

string

یک تابع سفارشی برای فراخوانی زمانی که عنصر حاوی کلیک یا فعال می شود.

برای مثال استفاده، به خواندن داده‌های فرم مراجعه کنید.

parameters[]

ActionParameter

لیست پارامترهای عمل

loadIndicator

LoadIndicator

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

persistValues

bool

نشان می دهد که آیا مقادیر فرم پس از عمل باقی می مانند یا خیر. مقدار پیش فرض false است.

اگر true ، مقادیر فرم پس از راه اندازی عمل باقی می مانند. برای اینکه کاربر در حین پردازش عملکرد تغییراتی ایجاد کند، LoadIndicator را روی NONE تنظیم کنید. برای پیام‌های کارت در برنامه‌های گپ، همچنین باید ResponseType عملکرد را روی UPDATE_MESSAGE تنظیم کنید و از همان card_id کارتی که حاوی کنش است استفاده کنید.

اگر false باشد، مقادیر فرم هنگام شروع عمل پاک می شوند. برای جلوگیری از ایجاد تغییرات توسط کاربر در حین پردازش، LoadIndicator را روی SPINNER تنظیم کنید.

interaction

Interaction

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

در پاسخ به تعامل با کاربر، مانند کلیک کردن روی دکمه در پیام کارت، چه کاری باید انجام دهید.

اگر مشخص نباشد، برنامه با اجرای یک action - مانند باز کردن یک پیوند یا اجرای یک تابع - به طور معمول پاسخ می دهد.

با مشخص کردن یک interaction ، برنامه می‌تواند به روش‌های تعاملی ویژه پاسخ دهد. برای مثال، با تنظیم interaction روی OPEN_DIALOG ، برنامه می‌تواند یک گفتگو را باز کند. وقتی مشخص شد، نشانگر بارگیری نشان داده نمی شود. اگر برای یک افزونه مشخص شده باشد، کل کارت حذف می شود و چیزی در مشتری نشان داده نمی شود.

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

requiredWidgets[]

string

اختیاری. این لیست را با نام ویجت هایی که این Action برای ارسال معتبر به آن نیاز دارد پر کنید.

اگر هنگام فراخوانی این اقدام، ویجت‌های فهرست‌شده در اینجا ارزشی نداشته باشند، ارسال فرم لغو می‌شود.

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

allWidgetsAreRequired

bool

اختیاری. اگر این درست باشد، تمام ویجت ها برای این عمل مورد نیاز در نظر گرفته می شوند.

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

ActionParameter

فهرست پارامترهای رشته ای که باید هنگام فراخوانی متد اقدام ارائه شوند. به عنوان مثال، سه دکمه چرت زدن را در نظر بگیرید: به تعویق انداختن اکنون، به تعویق انداختن یک روز، یا به تعویق انداختن هفته بعد. شما ممکن است از action method = snooze() استفاده کنید، از نوع snooze و زمان snooze در لیست پارامترهای رشته استفاده کنید.

برای کسب اطلاعات بیشتر، CommonEventObject را ببینید.

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

فیلدها
key

string

نام پارامتر برای اسکریپت اکشن.

value

string

مقدار پارامتر.

تعامل

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

در پاسخ به تعامل با کاربر، مانند کلیک کردن روی دکمه در پیام کارت، چه کاری باید انجام دهید.

اگر مشخص نباشد، برنامه با اجرای یک action - مانند باز کردن یک پیوند یا اجرای یک تابع - به طور معمول پاسخ می دهد.

با مشخص کردن یک interaction ، برنامه می‌تواند به روش‌های تعاملی ویژه پاسخ دهد. برای مثال، با تنظیم interaction روی OPEN_DIALOG ، برنامه می‌تواند یک گفتگو را باز کند.

وقتی مشخص شد، نشانگر بارگیری نشان داده نمی شود. اگر برای یک افزونه مشخص شده باشد، کل کارت حذف می شود و چیزی در مشتری نشان داده نمی شود.

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

Enums
INTERACTION_UNSPECIFIED مقدار پیش فرض action به طور معمول اجرا می شود.
OPEN_DIALOG

گفتگویی را باز می‌کند، یک رابط پنجره‌دار و مبتنی بر کارت که برنامه‌های گپ از آن برای تعامل با کاربران استفاده می‌کنند.

فقط توسط برنامه‌های چت در پاسخ به کلیک روی پیام‌های کارت پشتیبانی می‌شود. اگر برای یک افزونه مشخص شده باشد، کل کارت حذف می شود و چیزی در مشتری نشان داده نمی شود.

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

LoadIndicator

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

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

Enums
SPINNER یک اسپینر را نشان می دهد که نشان می دهد محتوا در حال بارگیری است.
NONE چیزی نمایش داده نمی شود.

سبک مرزی

گزینه های سبک برای حاشیه کارت یا ویجت، از جمله نوع حاشیه و رنگ.

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

فیلدها
type

BorderType

نوع حاشیه.

strokeColor

Color

رنگ‌هایی که باید زمانی که نوع BORDER_TYPE_STROKE استفاده می‌شوند.

برای تنظیم رنگ استروک، مقداری را برای فیلدهای red ، green و blue مشخص کنید. مقدار باید یک عدد شناور بین 0 و 1 بر اساس مقدار رنگ RGB باشد، که در آن 0 (0/255) نشان دهنده عدم وجود رنگ و 1 (255/255) نشان دهنده حداکثر شدت رنگ است.

به عنوان مثال، رنگ زیر را در حداکثر شدت آن بر روی قرمز تنظیم می کند:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

فیلد alpha برای رنگ سکته مغزی در دسترس نیست. اگر مشخص شده باشد، این فیلد نادیده گرفته می شود.

cornerRadius

int32

شعاع گوشه برای مرز.

نوع مرزی

نشان دهنده انواع حاشیه اعمال شده برای ویجت ها است.

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

Enums
BORDER_TYPE_UNSPECIFIED استفاده نکنید. نامشخص
NO_BORDER مقدار پیش فرض بدون مرز
STROKE طرح کلی.

دکمه

یک متن، نماد یا دکمه متن و نماد که کاربران می توانند روی آن کلیک کنند. برای مثال در برنامه‌های گپ Google، به افزودن دکمه مراجعه کنید.

برای تبدیل کردن یک تصویر به یک دکمه قابل کلیک، یک Image (نه ImageComponent ) را مشخص کنید و یک عمل onClick را تنظیم کنید.

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

فیلدها
text

string

متن نمایش داده شده در داخل دکمه

icon

Icon

یک نماد در داخل دکمه نمایش داده می شود. اگر icon و text هر دو تنظیم شده باشند، نماد قبل از متن ظاهر می شود.

color

Color

اختیاری. رنگ دکمه. در صورت تنظیم، type دکمه روی FILLED و رنگ text و قسمت icon برای خوانایی روی رنگ متضاد تنظیم می شود. به عنوان مثال، اگر رنگ دکمه روی آبی تنظیم شده باشد، هر متن یا نمادی در دکمه روی سفید تنظیم می شود.

برای تنظیم رنگ دکمه، مقداری برای فیلدهای red ، green و blue مشخص کنید. مقدار باید یک عدد شناور بین 0 و 1 بر اساس مقدار رنگ RGB باشد، که در آن 0 (0/255) نشان دهنده عدم وجود رنگ و 1 (255/255) نشان دهنده حداکثر شدت رنگ است.

به عنوان مثال، رنگ زیر را در حداکثر شدت آن بر روی قرمز تنظیم می کند:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

فیلد alpha برای رنگ دکمه در دسترس نیست. اگر مشخص شده باشد، این فیلد نادیده گرفته می شود.

onClick

OnClick

مورد نیاز. اقدامی که هنگام کلیک کاربر روی دکمه انجام می شود، مانند باز کردن یک پیوند یا اجرای یک عملکرد سفارشی.

disabled

bool

اگر true ، دکمه در حالت غیرفعال نمایش داده می شود و به اقدامات کاربر پاسخ نمی دهد.

altText

string

متن جایگزینی که برای دسترسی استفاده می شود.

متن توصیفی را تنظیم کنید که به کاربران اجازه دهد بدانند دکمه چه کاری انجام می دهد. برای مثال، اگر دکمه‌ای یک پیوند را باز می‌کند، می‌توانید بنویسید: «یک برگه مرورگر جدید را باز می‌کند و به اسناد توسعه‌دهنده Google Chat در https://developers.google.com/workspace/chat می‌رود» .

type

Type

اختیاری. نوع یک دکمه. اگر تنظیم نشده باشد، نوع دکمه پیش‌فرض OUTLINED است. اگر فیلد color تنظیم شود، نوع دکمه به اجبار FILLED می شود و هر مقدار تنظیم شده برای این فیلد نادیده گرفته می شود.

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

تایپ کنید

اختیاری. نوع یک دکمه. اگر فیلد color تنظیم شده باشد، type به اجبار FILLED می شود.

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

Enums
TYPE_UNSPECIFIED استفاده نکنید. نامشخص
OUTLINED دکمه های مشخص شده دکمه هایی با تاکید متوسط ​​هستند. آنها معمولاً حاوی اقدامات مهم هستند، اما اقدام اصلی در یک برنامه چت یا یک افزونه نیستند.
FILLED یک دکمه پر شده دارای ظرفی با رنگ ثابت است. بیشترین تأثیر بصری را دارد و برای اقدامات مهم و اولیه در یک برنامه چت یا یک افزونه توصیه می شود.
FILLED_TONAL یک دکمه تونال پر شده یک نقطه میانی جایگزین بین دکمه های پر شده و مشخص شده است. آنها در شرایطی که دکمه با اولویت کمتر به تاکید کمی بیشتر از یک دکمه طرح کلی نیاز دارد مفید هستند.
BORDERLESS یک دکمه در حالت پیش فرض خود محفظه نامرئی ندارد. اغلب برای اقدامات با کمترین اولویت استفاده می شود، به خصوص هنگام ارائه چندین گزینه.

ButtonList

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

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

فیلدها
buttons[]

Button

مجموعه ای از دکمه ها

کارت

رابط کارتی که در پیام Google Chat یا افزونه Google Workspace نمایش داده می‌شود.

کارت‌ها از طرح‌بندی تعریف‌شده، عناصر رابط کاربری تعاملی مانند دکمه‌ها و رسانه‌های غنی مانند تصاویر پشتیبانی می‌کنند. از کارت ها برای ارائه اطلاعات دقیق، جمع آوری اطلاعات از کاربران و راهنمایی کاربران برای برداشتن گام بعدی استفاده کنید.

طراحی و پیش نمایش کارت ها با Card Builder.

کارت ساز را باز کنید

برای یادگیری نحوه ساخت کارت، به مستندات زیر مراجعه کنید:

مثال: پیام کارت برای برنامه Google Chat

نمونه کارت تماس

برای ایجاد پیام کارت نمونه در Google Chat، از JSON زیر استفاده کنید:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "sasha@example.com"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
فیلدها
header

CardHeader

هدر کارت. یک هدر معمولا حاوی یک تصویر اصلی و یک عنوان است. هدرها همیشه در بالای کارت ظاهر می شوند.

sections[]

Section

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

sectionDividerStyle

DividerStyle

سبک تقسیم کننده بین بخش ها.

cardActions[]

CardAction

اقدامات کارت اقدامات به منوی نوار ابزار کارت اضافه می شود.

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

به عنوان مثال، JSON زیر یک منوی عملکرد کارت با گزینه‌های Settings و Send Feedback ایجاد می‌کند:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]
name

string

نام کارت. به عنوان شناسه کارت در ناوبری کارت استفاده می شود.

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

fixedFooter

CardFixedFooter

پاورقی ثابت که در پایین این کارت نشان داده شده است.

تنظیم fixedFooter بدون مشخص کردن یک primaryButton یا یک secondaryButton باعث ایجاد خطا می شود. برای برنامه‌های گپ، می‌توانید از فوترهای ثابت در گفتگوها استفاده کنید، اما از پیام‌های کارت استفاده نکنید.

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

displayStyle

DisplayStyle

در افزونه‌های Google Workspace، ویژگی‌های نمایش peekCardHeader را تنظیم می‌کند.

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

peekCardHeader

CardHeader

هنگام نمایش محتوای متنی، هدر کارت به عنوان یک مکان نگهدار عمل می کند تا کاربر بتواند بین کارت های صفحه اصلی و کارت های متنی به جلو حرکت کند.

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

CardAction

اکشن کارت، عمل مرتبط با کارت است. به عنوان مثال، یک کارت فاکتور ممکن است شامل اقداماتی مانند حذف فاکتور، فاکتور ایمیل یا باز کردن فاکتور در مرورگر باشد.

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

فیلدها
actionLabel

string

برچسبی که به عنوان آیتم منوی کنش نمایش داده می شود.

onClick

OnClick

عمل onClick برای این مورد اقدام.

CardFixedFooter

پاورقی ثابت (چسبنده) که در پایین کارت ظاهر می شود.

تنظیم fixedFooter بدون مشخص کردن یک primaryButton یا یک secondaryButton باعث ایجاد خطا می شود.

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

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

فیلدها
primaryButton

Button

دکمه اصلی فوتر ثابت. دکمه باید یک دکمه متنی با متن و مجموعه رنگ باشد.

secondaryButton

Button

دکمه ثانویه پاورقی ثابت. دکمه باید یک دکمه متنی با متن و مجموعه رنگ باشد. اگر secondaryButton تنظیم شده است، باید primaryButton نیز تنظیم کنید.

سربرگ کارت

نشان دهنده هدر کارت است. برای مثال در برنامه‌های گپ Google، به افزودن سرصفحه مراجعه کنید.

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

فیلدها
title

string

مورد نیاز. عنوان هدر کارت. سربرگ دارای ارتفاع ثابتی است: اگر عنوان و عنوان فرعی هر دو مشخص شده باشند، هر کدام یک خط را اشغال می کنند. اگر فقط عنوان مشخص شده باشد، هر دو خط را می گیرد.

subtitle

string

زیرنویس هدر کارت. در صورت مشخص شدن، در خط خودش زیر title ظاهر می شود.

imageType

ImageType

شکلی که برای برش تصویر استفاده می شود.

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

imageUrl

string

نشانی وب HTTPS تصویر در هدر کارت.

imageAltText

string

متن جایگزین این تصویر که برای دسترس‌پذیری استفاده می‌شود.

DisplayStyle

در افزونه‌های Google Workspace، نحوه نمایش کارت را تعیین می‌کند.

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

Enums
DISPLAY_STYLE_UNSPECIFIED استفاده نکنید. نامشخص
PEEK سرصفحه کارت در پایین نوار کناری ظاهر می شود و تا حدی کارت بالای فعلی پشته را می پوشاند. با کلیک روی هدر، کارت به پشته کارت می‌رود. اگر کارت فاقد هدر باشد، به جای آن از هدر تولید شده استفاده می شود.
REPLACE مقدار پیش فرض کارت با جایگزین کردن نمای کارت بالایی در پشته کارت نشان داده می شود.

DividerStyle

سبک تقسیم کننده یک کارت. در حال حاضر فقط برای تقسیم‌کننده‌های بین بخش‌های کارت استفاده می‌شود.

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

Enums
DIVIDER_STYLE_UNSPECIFIED استفاده نکنید. نامشخص
SOLID_DIVIDER گزینه پیش فرض یک تقسیم کننده جامد ارائه دهید.
NO_DIVIDER اگر تنظیم شود، هیچ تقسیم کننده ای ارائه نمی شود. این استایل جداکننده را به طور کامل از چیدمان حذف می کند. نتیجه معادل عدم اضافه کردن یک تقسیم کننده است.

بخش

یک بخش شامل مجموعه ای از ویجت ها است که به صورت عمودی به ترتیبی که مشخص شده اند ارائه می شوند.

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

فیلدها
header

string

متنی که در بالای یک بخش ظاهر می شود. پشتیبانی از متن ساده با فرمت HTML. برای اطلاعات بیشتر درباره قالب‌بندی متن، به قالب‌بندی متن در برنامه‌های چت Google و قالب‌بندی متن در افزونه‌های Google Workspace مراجعه کنید.

widgets[]

Widget

تمام ویجت های موجود در بخش باید حداقل یک ویجت داشته باشد.

collapsible

bool

نشان می دهد که آیا این بخش قابل جمع شدن است یا خیر.

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

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

uncollapsibleWidgetsCount

int32

تعداد ویجت‌های جمع نشدنی که حتی در صورت جمع شدن یک بخش قابل مشاهده باقی می‌مانند.

به عنوان مثال، هنگامی که یک بخش شامل پنج ویجت است و uncollapsibleWidgetsCount روی 2 تنظیم می شود، دو ویجت اول همیشه نشان داده می شوند و سه ویجت آخر به طور پیش فرض جمع می شوند. uncollapsibleWidgetsCount تنها زمانی در نظر گرفته می‌شود که collapsible true باشد.

collapseControl

CollapseControl

اختیاری. دکمه گسترش و کوچک کردن بخش را تعریف کنید. این دکمه فقط در صورتی نشان داده می شود که بخش قابل جمع شدن باشد. اگر این فیلد تنظیم نشده باشد، از دکمه پیش فرض استفاده می شود. برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

تراشه

یک متن، نماد یا تراشه متن و نماد که کاربران می توانند روی آن کلیک کنند.

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

فیلدها
icon

Icon

تصویر آیکون اگر icon و text هر دو تنظیم شده باشند، نماد قبل از متن ظاهر می شود.

label

string

متن نمایش داده شده در داخل تراشه.

onClick

OnClick

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

enabled
(deprecated)

bool

آیا تراشه در حالت فعال است و به اقدامات کاربر پاسخ می دهد. پیش فرض ها به true منسوخ شده است. به جای آن از disabled استفاده کنید.

disabled

bool

آیا تراشه در حالت غیرفعال است و اقدامات کاربر را نادیده می گیرد. پیش فرض ها به false .

altText

string

متن جایگزینی که برای دسترسی استفاده می شود.

متن توصیفی را تنظیم کنید که به کاربران اجازه دهد بدانند تراشه چه کاری انجام می دهد. به عنوان مثال، اگر تراشه‌ای پیوندی را باز می‌کند، بنویسید: «یک برگه مرورگر جدید را باز می‌کند و به اسناد توسعه‌دهنده Google Chat در https://developers.google.com/workspace/chat می‌رود» .

ChipList

فهرستی از تراشه‌هایی که به صورت افقی چیده شده‌اند، که می‌توانند به صورت افقی حرکت کنند یا به خط بعدی بپیچند.

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

فیلدها
layout

Layout

چیدمان لیست تراشه مشخص شده

chips[]

Chip

مجموعه ای از تراشه ها.

طرح بندی

چیدمان لیست تراشه ها

Enums
LAYOUT_UNSPECIFIED استفاده نکنید. نامشخص
WRAPPED مقدار پیش فرض اگر فضای افقی کافی وجود نداشته باشد، لیست تراشه ها به خط بعدی می رسد.
HORIZONTAL_SCROLLABLE اگر تراشه ها در فضای موجود جا نشوند، به صورت افقی حرکت می کنند.

CollapseControl

یک کنترل گسترش و فروپاشی را نشان می دهد. برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

فیلدها
horizontalAlignment

HorizontalAlignment

تراز افقی دکمه گسترش و جمع کردن.

expandButton

Button

اختیاری. یک دکمه قابل تنظیم برای گسترش بخش تعریف کنید. هر دو قسمت expandButton و collapseButton باید تنظیم شوند. فقط یک مجموعه فیلد اعمال نخواهد شد. اگر این فیلد تنظیم نشده باشد، از دکمه پیش فرض استفاده می شود.

collapseButton

Button

اختیاری. یک دکمه قابل تنظیم برای جمع کردن بخش تعریف کنید. هر دو قسمت expandButton و collapseButton باید تنظیم شوند. فقط یک مجموعه فیلد اعمال نخواهد شد. اگر این فیلد تنظیم نشده باشد، از دکمه پیش فرض استفاده می شود.

ستون ها

ویجت Columns حداکثر 2 ستون را در یک کارت یا گفتگو نمایش می دهد. شما می توانید ویجت ها را به هر ستون اضافه کنید. ویجت ها به ترتیبی که مشخص شده اند ظاهر می شوند. برای مثال در برنامه‌های گپ Google، به نمایش کارت‌ها و گفتگوها در ستون‌ها مراجعه کنید.

ارتفاع هر ستون توسط ستون بلندتر تعیین می شود. به عنوان مثال، اگر ستون اول از ستون دوم بلندتر باشد، هر دو ستون ارتفاع ستون اول را دارند. از آنجایی که هر ستون می تواند دارای تعداد متفاوتی از ویجت ها باشد، نمی توانید ردیف ها را تعریف کنید یا ویجت ها را بین ستون ها تراز کنید.

ستون ها در کنار هم نمایش داده می شوند. می توانید عرض هر ستون را با استفاده از فیلد HorizontalSizeStyle سفارشی کنید. اگر عرض صفحه کاربر خیلی باریک باشد، ستون دوم زیر ستون اول قرار می گیرد:

  • در وب، اگر عرض صفحه کمتر یا مساوی 480 پیکسل باشد، ستون دوم بسته می شود.
  • در دستگاه‌های iOS، اگر عرض صفحه کمتر یا مساوی 300 pt باشد، ستون دوم بسته می‌شود.
  • در دستگاه‌های Android، اگر عرض صفحه کمتر یا مساوی 320 dp باشد، ستون دوم بسته می‌شود.

برای گنجاندن بیش از 2 ستون یا استفاده از سطرها، از ویجت Grid استفاده کنید.

برای برنامه‌های گپ Google و افزونه‌های Google Workspace موجود است. UI های افزودنی که از ستون ها پشتیبانی می کنند عبارتند از:

  • هنگامی که کاربران افزونه را از پیش نویس ایمیل باز می کنند، گفتگو نمایش داده می شود.
  • هنگامی که کاربران افزونه را از منوی افزودن پیوست در یک رویداد Google Calendar باز می‌کنند، گفتگو نمایش داده می‌شود.
فیلدها
columnItems[]

Column

آرایه ای از ستون ها. می توانید حداکثر 2 ستون را در یک کارت یا گفتگو قرار دهید.

ستون

یک ستون

افزونه‌های Google Workspace و برنامه‌های چت

فیلدها
horizontalSizeStyle

HorizontalSizeStyle

نحوه پر کردن عرض کارت توسط یک ستون را مشخص می کند.

horizontalAlignment

HorizontalAlignment

تعیین می کند که آیا ویجت ها در سمت چپ، راست یا مرکز یک ستون تراز شوند.

verticalAlignment

VerticalAlignment

تعیین می کند که آیا ویجت ها در بالا، پایین یا مرکز یک ستون تراز شوند.

widgets[]

Widgets

آرایه ای از ویجت های موجود در یک ستون. ویجت ها به ترتیبی که مشخص شده اند ظاهر می شوند.

HorizontalSizeStyle

نحوه پر کردن عرض کارت توسط یک ستون را مشخص می کند. عرض هر ستون هم به HorizontalSizeStyle و هم به عرض ویجت های داخل ستون بستگی دارد.

افزونه‌های Google Workspace و برنامه‌های چت

Enums
HORIZONTAL_SIZE_STYLE_UNSPECIFIED استفاده نکنید. نامشخص
FILL_AVAILABLE_SPACE مقدار پیش فرض ستون فضای موجود را پر می کند، تا 70٪ از عرض کارت. اگر هر دو ستون روی FILL_AVAILABLE_SPACE تنظیم شده باشند، هر ستون 50٪ از فضا را پر می کند.
FILL_MINIMUM_SPACE ستون کمترین فضای ممکن را پر می کند و بیش از 30 درصد عرض کارت را ندارد.

تراز عمودی

تعیین می کند که آیا ویجت ها در بالا، پایین یا مرکز یک ستون تراز شوند.

افزونه‌های Google Workspace و برنامه‌های چت

Enums
VERTICAL_ALIGNMENT_UNSPECIFIED استفاده نکنید. نامشخص
CENTER مقدار پیش فرض ویجت ها را در مرکز یک ستون تراز می کند.
TOP ویجت ها را در بالای یک ستون تراز می کند.
BOTTOM ویجت ها را در پایین یک ستون تراز می کند.

ابزارک ها

ویجت های پشتیبانی شده که می توانید در یک ستون قرار دهید.

افزونه‌های Google Workspace و برنامه‌های چت

فیلدها

data میدان اتحادیه

data فقط می توانند یکی از موارد زیر باشند:

textParagraph

TextParagraph

ویجت TextParagraph .

image

Image

ویجت Image

decoratedText

DecoratedText

ویجت DecoratedText .

buttonList

ButtonList

ویجت ButtonList .

textInput

TextInput

ویجت TextInput

selectionInput

SelectionInput

ویجت SelectionInput .

dateTimePicker

DateTimePicker

ویجت DateTimePicker .

chipList

ChipList

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

DateTimePicker

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

کاربران می توانند متن را وارد کنند یا از انتخابگر برای انتخاب تاریخ و زمان استفاده کنند. اگر کاربران تاریخ یا زمان نامعتبری را وارد کنند، انتخابگر خطایی را نشان می دهد که از کاربران می خواهد اطلاعات را به درستی وارد کنند.

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

فیلدها
name

string

نامی که با آن DateTimePicker در یک رویداد ورودی فرم مشخص می شود.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

label

string

متنی که از کاربران می خواهد تاریخ، زمان یا تاریخ و ساعت را وارد کنند. برای مثال، اگر کاربران در حال برنامه ریزی قرار ملاقات هستند، از برچسبی مانند Appointment date یا Appointment date and time استفاده کنید.

type

DateTimePickerType

آیا ویجت از وارد کردن تاریخ، زمان یا تاریخ و زمان پشتیبانی می‌کند.

valueMsEpoch

int64

مقدار پیش‌فرض نمایش داده شده در ویجت، بر حسب میلی‌ثانیه از زمان یونیکس .

مقدار را بر اساس نوع انتخابگر ( DateTimePickerType ) مشخص کنید:

  • DATE_AND_TIME : تاریخ و زمان تقویم در UTC. به عنوان مثال، برای نمایش 1 ژانویه 2023 در ساعت 12:00 UTC، از 1672574400000 استفاده کنید.
  • DATE_ONLY : یک تاریخ تقویم در ساعت 00:00:00 UTC. به عنوان مثال، برای نشان دادن 1 ژانویه 2023، از 1672531200000 استفاده کنید.
  • TIME_ONLY : یک زمان در UTC. به عنوان مثال، برای نمایش ساعت 12:00، از 43200000 (یا 12 * 60 * 60 * 1000 ) استفاده کنید.
timezoneOffsetDate

int32

عددی که منطقه زمانی را از UTC برحسب دقیقه نشان می‌دهد. در صورت تنظیم، value_ms_epoch در منطقه زمانی مشخص شده نمایش داده می شود. اگر تنظیم نشود، مقدار به طور پیش‌فرض روی تنظیم منطقه زمانی کاربر است.

onChangeAction

Action

هنگامی که کاربر روی Save یا Clear از رابط DateTimePicker کلیک می کند، فعال می شود.

validation

Validation

اختیاری. اعتبار مورد نیاز برای این انتخابگر تاریخ تایمر را مشخص کنید.

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

DateTimePickerType

فرمت تاریخ و زمان در ویجت DateTimePicker . تعیین می کند که آیا کاربران می توانند تاریخ، زمان یا هر دو تاریخ و زمان را وارد کنند.

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

Enums
DATE_AND_TIME کاربران تاریخ و زمان را وارد می کنند.
DATE_ONLY کاربران تاریخ را وارد می کنند.
TIME_ONLY کاربران زمان را وارد می کنند.

متن تزئین شده

ویجتی که متنی را با تزئینات اختیاری مانند برچسب در بالا یا پایین متن، نماد جلوی متن، ویجت انتخاب یا دکمه بعد از متن نمایش می دهد. برای مثال در برنامه‌های چت Google، به نمایش متن با متن تزئینی مراجعه کنید.

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

فیلدها
icon
(deprecated)

Icon

به نفع startIcon منسوخ شد.

startIcon

Icon

نمادی که در جلوی متن نمایش داده می شود.

topLabel

string

متنی که در بالای text ظاهر می شود. همیشه کوتاه می شود.

text

string

مورد نیاز. متن اولیه

از قالب بندی ساده پشتیبانی می کند. برای اطلاعات بیشتر درباره قالب‌بندی متن، به قالب‌بندی متن در برنامه‌های چت Google و قالب‌بندی متن در افزونه‌های Google Workspace مراجعه کنید.

wrapText

bool

تنظیم متن بسته بندی. اگر true ، متن در چندین خط پیچیده و نمایش داده می شود. در غیر این صورت، متن کوتاه شده است.

فقط برای text اعمال می شود، نه topLabel و bottomLabel .

bottomLabel

string

متنی که در زیر text ظاهر می شود. همیشه می پیچد.

onClick

OnClick

این عمل زمانی فعال می شود که کاربران topLabel یا bottomLabel را کلیک کنند.

control میدان اتحادیه یک دکمه، سوئیچ، کادر انتخاب یا تصویری که در سمت راست متن در ویجت decoratedText ظاهر می شود. control فقط می تواند یکی از موارد زیر باشد:
button

Button

دکمه‌ای که کاربر می‌تواند روی آن کلیک کند تا یک اقدام را فعال کند.

switchControl

SwitchControl

ویجت سوئیچ که کاربر می تواند روی آن کلیک کند تا وضعیت آن را تغییر دهد و یک عمل را آغاز کند.

endIcon

Icon

یک نماد بعد از متن نمایش داده می شود.

پشتیبانی از آیکون های داخلی و سفارشی

SwitchControl

یا یک سوئیچ به سبک تغییر وضعیت یا یک چک باکس در داخل ویجت decoratedText .

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

فقط در ویجت decoratedText پشتیبانی می شود.

فیلدها
name

string

نامی که با آن ویجت سوئیچ در یک رویداد ورودی فرم شناسایی می شود.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

value

string

مقدار وارد شده توسط کاربر، به عنوان بخشی از یک رویداد ورودی فرم برگردانده می شود.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

selected

bool

وقتی true ، سوئیچ انتخاب می شود.

onChangeAction

Action

عملکردی که باید هنگام تغییر وضعیت سوئیچ انجام شود، مانند اینکه چه عملکردی باید اجرا شود.

controlType

ControlType

نحوه نمایش سوئیچ در رابط کاربری

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

نوع کنترل

نحوه نمایش سوئیچ در رابط کاربری

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

Enums
SWITCH یک سوئیچ به سبک ضامن.
CHECKBOX به نفع CHECK_BOX منسوخ شد.
CHECK_BOX یک چک باکس.

تقسیم کننده

این نوع هیچ فیلدی ندارد.

یک تقسیم کننده بین ویجت ها به صورت یک خط افقی نمایش می دهد. برای مثال در برنامه‌های Google Chat، به افزودن یک تقسیم‌کننده افقی بین ابزارک‌ها مراجعه کنید.

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

به عنوان مثال، JSON زیر یک تقسیم کننده ایجاد می کند:

"divider": {}

EndNavigation

عمل جریان گفتگو.

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

فیلدها
action

Action

عمل رندر برای مشتری برای پایان دادن به یک جریان گفتگو.

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

اقدام

انواع عملکرد رندر برای سرویس گیرنده برای پایان دادن به یک جریان گفتگو.

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

Enums
ACTION_UNSPECIFIED اقدام نامشخص
CLOSE_DIALOG جریان گفتگو را ببندید.
CLOSE_DIALOG_AND_EXECUTE جریان گفتگو را ببندید و کارتی را که جریان گفتگو را باز کرده است، بازخوانی کنید.

GetAutocompletionResponse

پاسخی به دریافت ظرف تکمیل خودکار، که شامل عناصر لازم برای نمایش موارد تکمیل خودکار برای فیلد نوشتاری است.

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

{
  "autoComplete": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
فیلدها
autoComplete

Suggestions

schema

string

این یک فیلد طرحواره بدون عملیات است که ممکن است در نشانه گذاری برای بررسی نحو وجود داشته باشد.

شبکه

شبکه ای را با مجموعه ای از آیتم ها نمایش می دهد. موارد فقط می توانند شامل متن یا تصویر باشند. برای ستون‌های واکنش‌گرا یا برای گنجاندن بیشتر از متن یا تصاویر، Columns استفاده کنید. برای مثال در برنامه‌های گپ Google، به نمایش یک شبکه با مجموعه‌ای از موارد مراجعه کنید.

یک شبکه از هر تعداد ستون و آیتم پشتیبانی می کند. تعداد سطرها بر اساس موارد تقسیم بر ستون تعیین می شود. یک شبکه با 10 مورد و 2 ستون دارای 5 ردیف است. یک شبکه با 11 مورد و 2 ستون دارای 6 ردیف است.

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

به عنوان مثال، JSON زیر یک شبکه 2 ستونی با یک آیتم ایجاد می کند:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
فیلدها
title

string

متنی که در هدر شبکه نمایش داده می شود.

items[]

GridItem

موارد برای نمایش در شبکه

borderStyle

BorderStyle

سبک حاشیه برای اعمال به هر مورد شبکه.

columnCount

int32

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

onClick

OnClick

این تماس مجدد توسط هر مورد شبکه جداگانه استفاده می شود، اما با شناسه و نمایه مورد در لیست موارد به پارامترهای پاسخ تماس اضافه شده است.

GridItem

یک مورد را در یک طرح شبکه ای نشان می دهد. موارد می توانند شامل متن، تصویر یا هر دو متن و تصویر باشند.

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

فیلدها
id

string

یک شناسه مشخص شده توسط کاربر برای این مورد شبکه. این شناسه در پارامترهای برگشت تماس onClick شبکه والد برگردانده می شود.

image

ImageComponent

تصویری که در آیتم شبکه نمایش داده می شود.

title

string

عنوان آیتم گرید.

subtitle

string

زیرنویس مورد گرید.

layout

GridItemLayout

طرح مورد استفاده برای آیتم شبکه.

GridItemLayout

گزینه های مختلف طرح بندی موجود برای یک آیتم شبکه را نشان می دهد.

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

Enums
GRID_ITEM_LAYOUT_UNSPECIFIED استفاده نکنید. نامشخص
TEXT_BELOW عنوان و عنوان فرعی در زیر تصویر آیتم شبکه نشان داده شده است.
TEXT_ABOVE عنوان و عنوان فرعی در بالای تصویر مورد شبکه نشان داده شده است.

نماد

نمادی که در ویجت روی کارت نمایش داده می شود. برای مثال در برنامه‌های گپ Google، به افزودن نماد مراجعه کنید.

پشتیبانی از آیکون های داخلی و سفارشی

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

فیلدها
altText

string

اختیاری. شرح نماد مورد استفاده برای دسترسی. اگر مشخص نشده باشد، Button مقدار پیش فرض ارائه می شود. به عنوان بهترین روش، باید توضیحات مفیدی را برای آنچه نماد نمایش می دهد، و در صورت وجود، کاری که انجام می دهد تنظیم کنید. به عنوان مثال، A user's account portrait ، یا Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat .

اگر نماد در یک Button تنظیم شده باشد، وقتی کاربر روی دکمه قرار می گیرد، altText به عنوان متن کمکی ظاهر می شود. با این حال، اگر دکمه text نیز تنظیم کند، altText نماد نادیده گرفته می‌شود.

imageType

ImageType

سبک برش به تصویر اعمال می شود. در برخی موارد، اعمال برش CIRCLE باعث می شود که تصویر بزرگتر از یک نماد داخلی کشیده شود.

icons فیلد اتحادیه نماد نمایش داده شده در ویجت روی کارت. icons فقط می توانند یکی از موارد زیر باشند:
knownIcon

string

یکی از نمادهای داخلی ارائه شده توسط Google Workspace را نمایش دهید.

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

برای فهرست کامل نمادهای پشتیبانی شده، به نمادهای داخلی مراجعه کنید.

iconUrl

string

یک نماد سفارشی که در یک URL HTTPS میزبانی شده است را نمایش دهید.

به عنوان مثال:

"iconUrl":
"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"

انواع فایل های پشتیبانی شده عبارتند از .png و .jpg .

materialIcon

MaterialIcon

یکی از نمادهای Google Material را نمایش دهید.

به عنوان مثال، برای نمایش نماد چک باکس ، استفاده کنید

"materialIcon": {
  "name": "check_box"
}

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

تصویر

تصویری که توسط یک URL مشخص می شود و می تواند یک عمل onClick داشته باشد. برای مثال، افزودن تصویر را ببینید.

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

فیلدها
imageUrl

string

URL HTTPS که تصویر را میزبانی می کند.

به عنوان مثال: 

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
onClick

OnClick

وقتی کاربر روی تصویر کلیک می کند، کلیک این عمل را آغاز می کند.

altText

string

متن جایگزین این تصویر که برای دسترس‌پذیری استفاده می‌شود.

ImageComponent

یک تصویر را نشان می دهد.

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

فیلدها
imageUri

string

آدرس تصویر.

altText

string

برچسب دسترسی برای تصویر.

cropStyle

ImageCropStyle

سبک برش برای اعمال بر روی تصویر.

borderStyle

BorderStyle

سبک حاشیه برای اعمال بر روی تصویر.

ImageCropStyle

نشان دهنده سبک برش اعمال شده بر روی یک تصویر است.

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

برای مثال، در اینجا نحوه اعمال نسبت تصویر 16:9 آمده است: 

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
فیلدها
type

ImageCropType

نوع محصول

aspectRatio

double

اگر نوع برش RECTANGLE_CUSTOM باشد، نسبت تصویر استفاده می‌شود.

برای مثال، در اینجا نحوه اعمال نسبت تصویر 16:9 آمده است: 

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

ImageCropType

نشان دهنده سبک برش اعمال شده بر روی یک تصویر است.

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

Enums
IMAGE_CROP_TYPE_UNSPECIFIED استفاده نکنید. نامشخص
SQUARE مقدار پیش فرض برش مربع را اعمال می کند.
CIRCLE برش دایره ای را اعمال می کند.
RECTANGLE_CUSTOM یک برش مستطیلی با نسبت ابعاد سفارشی اعمال می کند. نسبت ابعاد سفارشی را با aspectRatio تنظیم کنید.
RECTANGLE_4_3 یک برش مستطیلی با نسبت تصویر 4:3 اعمال می کند.

پیش نمایش لینک

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

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

به عنوان مثال، JSON زیر یک عنوان منحصر به فرد برای پیش‌نمایش پیوند و تراشه هوشمند آن و یک کارت پیش‌نمایش با هدر و توضیحات متن برمی‌گرداند: 

{
  "action": {
    "linkPreview": {
      "title": "Smart chip title",
      "linkPreviewTitle": "Link preview title",
      "previewCard": {
        "header": {
          "title": "Preview card header",
        },
        "sections": [
          {
            "widgets": [
              {
                "textParagraph": {
                  "text": "Description of the link."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

مثال پیش نمایش لینک زیر را برمی گرداند:

نمونه پیش نمایش لینک

فیلدها
previewCard

Card

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

title

string

عنوانی که در تراشه هوشمند برای پیش نمایش پیوند نمایش داده می شود. اگر تنظیم نشود، تراشه هوشمند هدر preview_card را نمایش می‌دهد.

linkPreviewTitle

string

عنوانی که در پیش نمایش پیوند نمایش داده می شود. اگر تنظیم نشود، پیش‌نمایش پیوند سرصفحه preview_card را نشان می‌دهد.

MaterialIcon

یک نماد Google Material ، که شامل بیش از 2500 گزینه است.

به عنوان مثال، برای نمایش نماد چک باکس با وزن و درجه سفارشی، موارد زیر را بنویسید: 

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

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

فیلدها
name

string

نام نماد تعریف شده در نماد Google Material ، به عنوان مثال، check_box . نام‌های نامعتبر کنار گذاشته می‌شوند و با رشته‌های خالی جایگزین می‌شوند و باعث می‌شود نماد نمایش داده نشود.

fill

bool

آیا نماد پر شده است. مقدار پیش فرض نادرست است.

برای پیش نمایش تنظیمات نمادهای مختلف، به Google Font Icons بروید و تنظیمات را در قسمت Customize انجام دهید.

weight

int32

وزن ضربه ای نماد. از بین {100، 200، 300، 400، 500، 600، 700} انتخاب کنید. در صورت عدم وجود، مقدار پیش فرض 400 است. اگر مقدار دیگری مشخص شده باشد، از مقدار پیش فرض استفاده می شود.

برای پیش نمایش تنظیمات نمادهای مختلف، به Google Font Icons بروید و تنظیمات را در قسمت Customize انجام دهید.

grade

int32

وزن و درجه بر ضخامت نماد تأثیر می گذارد. تنظیمات درجه نسبت به تنظیم وزن دانه بندی بیشتری دارند و تأثیر کمی بر اندازه نماد دارند. از بین {-25، 0، 200} انتخاب کنید. در صورت عدم وجود، مقدار پیش فرض 0 است. اگر مقدار دیگری مشخص شده باشد، از مقدار پیش فرض استفاده می شود.

برای پیش نمایش تنظیمات نمادهای مختلف، به Google Font Icons بروید و تنظیمات را در قسمت Customize انجام دهید.

عملکرد کارت که پشته کارت را دستکاری می کند.

به عنوان مثال:

1) یک کارت جدید به پشته اضافه کنید (به جلو حرکت کنید). برای برنامه‌های گپ، فقط برای صفحه اصلی برنامه موجود است.

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

 navigations : {
    pushCard : CARD
  }

2) کارت را در بالای پشته به روز کنید (به روز رسانی در محل).

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

  navigations : {
    popCard : true,
  }, {
    pushCard : CARD
  }

3) بدون به روز رسانی یک قدم به عقب برگردید.

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

  navigations : {
    popCard : true,
  }

4) چند مرحله به عقب برگردید و آن کارت را به روز کنید.

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

  navigations : {
    popCard : true,
  }, ... {
    pushCard : CARD
  }

5) چند مرحله به یک CARD_NAME تعریف شده برگردید.

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

  navigations : {
    popToCardName : CARD_NAME,
  }, {
    pushCard : CARD
  }

6) به روت برگردید و آن کارت را آپدیت کنید.

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

  navigations : {
    popToRoot : true
  }, {
    pushCard : CARD
  }

7) به کارت مشخص شده بروید و آن را نیز پاپ کنید.

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

navigations : { popToCardName : CARD_NAME }, { popCard : true, }

8) کارت بالایی را با یک کارت جدید جایگزین کنید. برای برنامه‌های گپ، فقط برای صفحه اصلی برنامه موجود است.

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

  navigations : {
    updateCard : CARD
  }
فیلدها

فیلد اتحادیه navigate_action .

navigate_action می تواند تنها یکی از موارد زیر باشد:

popToRoot

bool

پشته کارت همه کارت ها را به جز کارت ریشه حذف می کند.

pop

bool

پشته کارت یک کارت جدا می شود.

popToCard

string

پشته کارت همه کارت ها را بالای کارت مشخص شده با نام کارت مشخص می کند.

pushCard

Card

پشته کارت یک کارت را روی پشته کارت هل می دهد.

updateCard

Card

پشته کارت کارت بالایی را با یک کارت جدید به روز می کند و مقادیر فیلدهای فرم پر شده را حفظ می کند. برای یک فیلد غیر معادل، مقدار حذف می شود.

endNavigation

EndNavigation

عمل ناوبری پایان جریان گفتگو. برای اطلاعات بیشتر، به ساخت صفحه اصلی برای برنامه چت Google مراجعه کنید

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

اطلاع رسانی

عملکرد کارت که یک اعلان را در برنامه میزبان نمایش می دهد.

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

فیلدها
text

string

متن ساده برای نمایش برای اعلان، بدون برچسب های HTML.

OnClick

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

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

فیلدها

data میدان اتحادیه

data فقط می توانند یکی از موارد زیر باشند:

action

Action

اگر مشخص شده باشد، یک عمل با این onClick فعال می شود.

openDynamicLinkAction

Action

هنگامی که اقدام نیاز به باز کردن پیوند داشته باشد، یک افزونه این عمل را فعال می کند. این تفاوت با open_link بالا در این است که برای دریافت لینک باید با سرور صحبت کنید. بنابراین برخی از کارهای آماده سازی برای وب کلاینت لازم است که قبل از بازگشت پاسخ عمل پیوند باز انجام شود.

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

card

Card

در صورت مشخص شدن، پس از کلیک کردن، یک کارت جدید به پشته کارت هل داده می شود.

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

overflowMenu

OverflowMenu

اگر مشخص شده باشد، این onClick منوی سرریز را باز می کند. برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

OnClose

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

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

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

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

Enums
NOTHING مقدار پیش فرض کارت دوباره بارگیری نمی شود. هیچ اتفاقی نمی افتد
RELOAD

پس از بسته شدن پنجره فرزند، کارت را دوباره بارگیری می کند.

اگر همراه با OpenAs.OVERLAY استفاده شود، پنجره فرزند به عنوان یک گفتگوی معین عمل می کند و کارت والد تا بسته شدن پنجره فرزند مسدود می شود.

OpenAs

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

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

Enums
FULL_SIZE پیوند به عنوان یک پنجره با اندازه کامل باز می شود (اگر این قاب مورد استفاده مشتری باشد).
OVERLAY پیوند به عنوان یک پوشش باز می شود، مانند یک پاپ آپ.

منوی سرریز

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

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

فیلدها
items[]

OverflowMenuItem

مورد نیاز. لیست گزینه های منو

OverflowMenuItem

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

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

فیلدها
startIcon

Icon

نمادی که در جلوی متن نمایش داده می شود.

text

string

مورد نیاز. متنی که مورد را برای کاربران شناسایی یا توصیف می کند.

onClick

OnClick

مورد نیاز. عملی که هنگام انتخاب گزینه منو فراخوانی می شود. این OnClick نمی‌تواند شامل OverflowMenu باشد، هر OverflowMenu مشخص شده حذف می‌شود و آیتم منو غیرفعال می‌شود.

disabled

bool

اینکه آیا گزینه منو غیرفعال است یا خیر. پیش فرض به نادرست.

RenderActions

مجموعه‌ای از دستورالعمل‌های رندر که به کارت می‌گوید یک عملکرد را انجام دهد، یا به برنامه میزبان افزودنی یا برنامه چت می‌گوید که یک عملکرد خاص برنامه را انجام دهد.

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

فیلدها
action

Action

hostAppAction

HostAppActionMarkup

اقدامات انجام شده توسط برنامه های میزبان جداگانه.

schema

string

این یک فیلد طرحواره بدون عملیات است که ممکن است در نشانه گذاری برای بررسی نحو وجود داشته باشد.

اقدام

فیلدها
navigations[]

Navigation

کارت های نمایش داده شده را فشار دهید، باز کنید یا به روز کنید.

notification

Notification

نمایش یک اعلان به کاربر نهایی

linkPreview

LinkPreview

نمایش پیش نمایش پیوند به کاربر نهایی.

SelectionInput

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

برنامه‌های چت می‌توانند مقدار مواردی را که کاربران انتخاب یا وارد می‌کنند پردازش کنند. برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

برای جمع آوری داده های تعریف نشده یا انتزاعی از کاربران، از ویجت TextInput استفاده کنید.

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

فیلدها
name

string

مورد نیاز. نامی که ورودی انتخاب را در رویداد ورودی فرم مشخص می کند.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

label

string

متنی که در بالای فیلد ورودی انتخاب در رابط کاربری ظاهر می شود.

متنی را مشخص کنید که به کاربر کمک کند اطلاعات مورد نیاز برنامه شما را وارد کند. به عنوان مثال، اگر کاربران فوریت یک بلیط کار را از یک منوی کشویی انتخاب می کنند، ممکن است برچسب "فوریت" یا "انتخاب فوریت" باشد.

type

SelectionType

نوع مواردی که در ویجت SelectionInput به کاربران نمایش داده می شود. انواع انتخاب انواع مختلفی از تعاملات را پشتیبانی می کند. برای مثال، کاربران می‌توانند یک یا چند چک باکس را انتخاب کنند، اما فقط می‌توانند یک مقدار را از منوی کشویی انتخاب کنند.

items[]

SelectionItem

مجموعه ای از آیتم های قابل انتخاب به عنوان مثال، مجموعه ای از دکمه های رادیویی یا چک باکس. تا 100 مورد را پشتیبانی می کند.

onChangeAction

Action

اگر مشخص شده باشد، هنگام تغییر انتخاب، فرم ارسال می شود. اگر مشخص نیست، باید یک دکمه جداگانه برای ارسال فرم مشخص کنید.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

multiSelectMaxSelectedItems

int32

برای منوهای چند انتخابی، حداکثر تعداد مواردی که کاربر می تواند انتخاب کند. حداقل مقدار 1 مورد است. اگر نامشخص است، به طور پیش فرض روی 3 مورد است.

multiSelectMinQueryLength

int32

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

اگر مشخص نشده باشد، 0 کاراکتر برای منابع داده ایستا و 3 نویسه برای منابع داده خارجی به طور پیش فرض تنظیم می شود.

validation

Validation

برای منوهای کشویی، اعتبارسنجی این فیلد ورودی انتخابی.

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

فیلد اتحادیه multi_select_data_source . برای یک منوی چند انتخابی، منبع داده ای که آیتم های انتخابی را پر می کند.

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

externalDataSource

Action

یک منبع داده خارجی، مانند پایگاه داده رابطه ای.

platformDataSource

PlatformDataSource

منبع داده از Google Workspace.

PlatformData Source

برای ویجت SelectionInput که از منوی چند انتخابی، منبع داده از Google Workspace استفاده می کند. برای پر کردن آیتم ها در منوی چند انتخابی استفاده می شود.

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

فیلدها
data_source فیلد اتحادیه . منبع داده data_source تنها می تواند یکی از موارد زیر باشد:
commonDataSource

CommonDataSource

یک منبع داده به اشتراک گذاشته شده توسط همه برنامه های Google Workspace، مانند کاربران در یک سازمان Google Workspace.

hostAppDataSource

HostAppDataSourceMarkup

منبع داده ای که منحصر به یک برنامه میزبان Google Workspace است، مانند فضاهای موجود در Google Chat.

این فیلد از کتابخانه های سرویس گیرنده Google API پشتیبانی می کند اما در کتابخانه های سرویس گیرنده ابری موجود نیست. برای کسب اطلاعات بیشتر، به نصب کتابخانه های سرویس گیرنده مراجعه کنید.

CommonDataSource

یک منبع داده به اشتراک گذاشته شده توسط همه برنامه های Google Workspace .

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

Enums
UNKNOWN مقدار پیش فرض استفاده نکنید.
USER کاربران Google Workspace کاربر فقط می تواند کاربران را از سازمان Google Workspace خود مشاهده و انتخاب کند.

انتخاب آیتم

موردی که کاربران می‌توانند در ورودی انتخاب انتخاب کنند، مانند چک باکس یا سوئیچ.

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

فیلدها
text

string

متنی که مورد را برای کاربران شناسایی یا توصیف می کند.

value

string

مقدار مرتبط با این مورد. مشتری باید از این به عنوان مقدار ورودی فرم استفاده کند.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

selected

bool

اینکه آیا مورد به طور پیش فرض انتخاب شده است یا خیر. اگر ورودی انتخاب فقط یک مقدار را می پذیرد (مانند دکمه های رادیویی یا یک منوی کشویی)، این قسمت را فقط برای یک مورد تنظیم کنید.

startIconUri

string

برای منوهای چند انتخابی، نشانی اینترنتی نماد در کنار فیلد text مورد نمایش داده می‌شود. پشتیبانی از فایل های PNG و JPEG باید یک URL HTTPS باشد. برای مثال، https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png .

bottomText

string

برای منوهای چند انتخابی، توضیح متنی یا برچسبی که در زیر فیلد text مورد نمایش داده می‌شود.

SelectionType

قالب مواردی که کاربران می توانند انتخاب کنند. گزینه های مختلف از انواع مختلفی از تعاملات پشتیبانی می کنند. به عنوان مثال، کاربران می توانند چندین چک باکس را انتخاب کنند، اما فقط می توانند یک مورد را از منوی کشویی انتخاب کنند.

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

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

Enums
CHECK_BOX مجموعه ای از چک باکس ها. کاربران می توانند یک یا چند چک باکس را انتخاب کنند.
RADIO_BUTTON مجموعه ای از دکمه های رادیویی کاربران می توانند یک دکمه رادیویی را انتخاب کنند.
SWITCH مجموعه ای از سوئیچ ها. کاربران می توانند یک یا چند سوئیچ را روشن کنند.
DROPDOWN یک منوی کشویی کاربران می توانند یک مورد را از منو انتخاب کنند.
MULTI_SELECT

یک منوی چند انتخابی برای داده های ایستا یا پویا. از نوار منو، کاربران یک یا چند مورد را انتخاب می کنند. کاربران همچنین می توانند مقادیری را برای پر کردن داده های پویا وارد کنند. به عنوان مثال، کاربران می توانند شروع به تایپ نام فضای چت Google کنند و ویجت به طور خودکار فضا را پیشنهاد می کند.

برای پر کردن آیتم‌ها برای منوی چند انتخابی، می‌توانید از یکی از انواع منابع داده زیر استفاده کنید:

  • داده های ثابت: موارد به عنوان اشیاء SelectionItem در ویجت مشخص می شوند. تا 100 مورد.
  • داده‌های Google Workspace: موارد با استفاده از داده‌های Google Workspace، مانند کاربران Google Workspace یا فضاهای Google Chat، پر می‌شوند.
  • داده های خارجی: موارد از یک منبع داده خارجی خارج از Google Workspace پر می شوند.

برای مثالهایی از نحوه اجرای منوهای چند انتخابی، به افزودن منوی چند انتخابی مراجعه کنید.

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

SubmitFormResponse

پاسخی به فرم ارسالی به غیر از دریافت یک محفظه تکمیل خودکار، که حاوی اقداماتی است که کارت باید انجام دهد و/یا برنامه میزبان افزودنی باید انجام دهد و اینکه آیا وضعیت کارت تغییر کرده است.

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

{
  "renderActions": {
    "action": {
      "notification": {
        "text": "Email address is added: salam.heba@example.com"
      }
    },
    "hostAppAction": {
      "gmailAction": {
        "openCreatedDraftAction": {
          "draftId": "msg-a:r-79766936926021702",
          "threadServerPermId": "thread-f:15700999851086004"
        }
      }
    }
  }
}
فیلدها
renderActions

RenderActions

مجموعه‌ای از دستورالعمل‌های رندر که به کارت می‌گوید یک عمل را انجام دهد و/یا به برنامه میزبان افزودنی می‌گوید یک عملکرد خاص برنامه را انجام دهد.

stateChanged

bool

اینکه آیا وضعیت کارت‌ها تغییر کرده است و داده‌های موجود در کارت‌های موجود کهنه است یا خیر.

schema

string

این یک فیلد طرحواره بدون عملیات است که ممکن است در نشانه گذاری برای بررسی نحو وجود داشته باشد.

پیشنهادات

مقادیر پیشنهادی که کاربران می توانند وارد کنند. این مقادیر زمانی ظاهر می شوند که کاربران داخل فیلد ورودی متن کلیک می کنند. همانطور که کاربران تایپ می کنند، مقادیر پیشنهادی به صورت پویا فیلتر می شوند تا با آنچه کاربران تایپ کرده اند مطابقت داشته باشد.

به عنوان مثال، یک فیلد ورودی متن برای زبان برنامه نویسی ممکن است جاوا، جاوا اسکریپت، پایتون و C++ را پیشنهاد کند. هنگامی که کاربران شروع به تایپ Jav می کنند، لیست پیشنهادات برای نمایش Java و JavaScript فیلتر می شود.

مقادیر پیشنهادی به کاربران کمک می‌کند تا مقادیری را وارد کنند که برنامه شما می‌تواند از آنها استفاده کند. هنگام مراجعه به جاوا اسکریپت، برخی از کاربران ممکن است javascript و برخی دیگر java script را وارد کنند. پیشنهاد JavaScript می تواند نحوه تعامل کاربران با برنامه شما را استاندارد کند.

وقتی مشخص شد، TextInput.type همیشه SINGLE_LINE است، حتی اگر روی MULTIPLE_LINE تنظیم شده باشد.

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

فیلدها
items[]

SuggestionItem

فهرستی از پیشنهادات مورد استفاده برای توصیه‌های تکمیل خودکار در فیلدهای ورودی متن.

آیتم پیشنهادی

یک مقدار پیشنهادی که کاربران می توانند در قسمت ورودی متن وارد کنند.

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

فیلدها

content زمینه اتحادیه

content فقط می تواند یکی از موارد زیر باشد:

text

string

مقدار یک ورودی پیشنهادی برای یک فیلد ورودی متن. این معادل چیزی است که کاربران خودشان وارد می کنند.

TextInput

فیلدی که کاربران می توانند متن را در آن وارد کنند. از پیشنهادات و اقدامات در حال تغییر پشتیبانی می کند. برای مثال در برنامه‌های گپ Google، به افزودن فیلدی که کاربر می‌تواند متن را در آن وارد کند، مراجعه کنید.

برنامه‌های چت مقدار متن وارد شده را در طول رویدادهای ورودی فرم دریافت می‌کنند و می‌توانند آن را پردازش کنند. برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

هنگامی که نیاز به جمع آوری داده های تعریف نشده یا انتزاعی از کاربران دارید، از ورودی متن استفاده کنید. برای جمع آوری داده های تعریف شده یا شمارش شده از کاربران، از ویجت SelectionInput استفاده کنید.

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

فیلدها
name

string

نامی که با آن ورودی متن در رویداد ورودی فرم مشخص می شود.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

label

string

متنی که در بالای فیلد ورودی متن در رابط کاربری ظاهر می شود.

متنی را مشخص کنید که به کاربر کمک کند اطلاعات مورد نیاز برنامه شما را وارد کند. برای مثال، اگر نام شخصی را می‌پرسید، اما به طور خاص به نام خانوادگی او نیاز دارید، به جای name ، surname را بنویسید.

اگر hintText نامشخص باشد، لازم است. در غیر این صورت اختیاری است.

hintText

string

متنی که در زیر فیلد ورودی متن ظاهر می‌شود، برای کمک به کاربران با درخواست از آنها برای وارد کردن یک مقدار مشخص است. این متن همیشه قابل مشاهده است.

اگر label نامشخص باشد، الزامی است. در غیر این صورت اختیاری است.

value

string

مقدار وارد شده توسط کاربر، به عنوان بخشی از یک رویداد ورودی فرم برگردانده می شود.

برای جزئیات کار با ورودی های فرم، به دریافت داده های فرم مراجعه کنید.

type

Type

نحوه نمایش فیلد ورودی متن در رابط کاربری مثلاً فیلد تک خطی باشد یا چند خطی.

onChangeAction

Action

وقتی تغییری در قسمت ورودی متن رخ می دهد چه باید کرد. به عنوان مثال، کاربر در حال افزودن به فیلد یا حذف متن.

نمونه‌هایی از اقداماتی که باید انجام دهید شامل اجرای یک عملکرد سفارشی یا باز کردن یک گفتگو در چت Google است.

initialSuggestions

Suggestions

مقادیر پیشنهادی که کاربران می توانند وارد کنند. این مقادیر زمانی ظاهر می شوند که کاربران داخل فیلد ورودی متن کلیک می کنند. همانطور که کاربران تایپ می کنند، مقادیر پیشنهادی به صورت پویا فیلتر می شوند تا با آنچه کاربران تایپ کرده اند مطابقت داشته باشد.

به عنوان مثال، یک فیلد ورودی متن برای زبان برنامه نویسی ممکن است جاوا، جاوا اسکریپت، پایتون و C++ را پیشنهاد کند. هنگامی که کاربران شروع به تایپ Jav می کنند، لیست پیشنهادات برای نشان دادن Java و JavaScript فیلتر می شود.

مقادیر پیشنهادی به کاربران کمک می‌کند تا مقادیری را وارد کنند که برنامه شما می‌تواند از آنها استفاده کند. هنگام مراجعه به جاوا اسکریپت، برخی از کاربران ممکن است javascript و برخی دیگر java script را وارد کنند. پیشنهاد JavaScript می تواند نحوه تعامل کاربران با برنامه شما را استاندارد کند.

وقتی مشخص شد، TextInput.type همیشه SINGLE_LINE است، حتی اگر روی MULTIPLE_LINE تنظیم شده باشد.

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

autoCompleteAction

Action

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

اگر مشخص نشده باشد، پیشنهادات توسط initialSuggestions تنظیم می شوند و توسط مشتری پردازش می شوند.

اگر مشخص شده باشد، برنامه عملکرد مشخص شده در اینجا را انجام می دهد، مانند اجرای یک تابع سفارشی.

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

validation

Validation

اعتبار سنجی لازم برای این فیلد ورودی متن را مشخص کنید.

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

placeholderText

string

متنی که وقتی فیلد خالی است در قسمت ورودی متن ظاهر می شود. از این متن برای درخواست از کاربران برای وارد کردن یک مقدار استفاده کنید. به عنوان مثال، Enter a number from 0 to 100 .

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

تایپ کنید

نحوه نمایش فیلد ورودی متن در رابط کاربری برای مثال، چه یک فیلد ورودی تک خطی باشد یا یک ورودی چند خطی. اگر initialSuggestions مشخص شده باشد، type همیشه SINGLE_LINE است، حتی اگر روی MULTIPLE_LINE تنظیم شده باشد.

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

Enums
SINGLE_LINE فیلد ورودی متن دارای ارتفاع ثابت یک خط است.
MULTIPLE_LINE فیلد ورودی متن دارای ارتفاع ثابتی از چندین خط است.

متن پاراگراف

پاراگراف متنی که از قالب بندی پشتیبانی می کند. برای مثال در برنامه‌های گپ Google، به افزودن پاراگراف متن قالب‌بندی شده مراجعه کنید. برای اطلاعات بیشتر درباره قالب‌بندی متن، به قالب‌بندی متن در برنامه‌های چت Google و قالب‌بندی متن در افزونه‌های Google Workspace مراجعه کنید.

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

فیلدها
text

string

متنی که در ویجت نشان داده شده است.

maxLines

int32

حداکثر تعداد خطوط متنی که در ویجت نمایش داده می شود. اگر متن از حداکثر تعداد خطوط تعیین شده بیشتر شود، محتوای اضافی در پشت دکمه نمایش بیشتر پنهان می شود. اگر متن مساوی یا کوتاهتر از حداکثر تعداد خطوط تعیین شده باشد، دکمه نمایش بیشتر نمایش داده نمی شود.

مقدار پیش فرض 0 است که در این حالت تمام زمینه نمایش داده می شود. ارزش های منفی نادیده گرفته می شوند. برای برنامه‌های Google Chat در دسترس است و برای افزونه‌های Google Workspace در دسترس نیست.

اعتبار سنجی

نشان دهنده داده های لازم برای اعتبارسنجی ویجتی است که به آن پیوست شده است.

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

فیلدها
characterLimit

int32

محدودیت کاراکتر را برای ویجت های ورودی متن مشخص کنید. توجه داشته باشید که این فقط برای ورودی متن استفاده می شود و برای سایر ویجت ها نادیده گرفته می شود.

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

inputType

InputType

نوع ویجت های ورودی را مشخص کنید.

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

نوع ورودی

نوع ویجت ورودی

Enums
INPUT_TYPE_UNSPECIFIED نوع نامشخص استفاده نکنید.
TEXT متن معمولی که همه کاراکترها را می پذیرد.
INTEGER یک مقدار صحیح
FLOAT یک مقدار شناور.
EMAIL یک آدرس ایمیل
EMOJI_PICKER ایموجی انتخاب شده از انتخابگر شکلک ارائه شده توسط سیستم.

ویجت

هر کارت از ویجت ها تشکیل شده است.

ویجت یک شی ترکیبی است که می تواند یکی از متن، تصاویر، دکمه ها و دیگر انواع شی را نشان دهد.

فیلدها
horizontalAlignment

HorizontalAlignment

تعیین می کند که آیا ویجت ها در سمت چپ، راست یا مرکز یک ستون تراز شوند.

data میدان اتحادیه یک ویجت فقط می تواند یکی از موارد زیر را داشته باشد. می توانید از چندین فیلد ویجت برای نمایش موارد بیشتر استفاده کنید. data فقط می توانند یکی از موارد زیر باشند:
textParagraph

TextParagraph

یک پاراگراف متنی را نمایش می دهد. پشتیبانی از متن ساده با فرمت HTML. برای اطلاعات بیشتر درباره قالب‌بندی متن، به قالب‌بندی متن در برنامه‌های چت Google و قالب‌بندی متن در افزونه‌های Google Workspace مراجعه کنید.

به عنوان مثال، JSON زیر یک متن پررنگ ایجاد می کند: 

"textParagraph": {
  "text": "  <b>bold text</b>"
}
image

Image

تصویری را نمایش می دهد.

به عنوان مثال، JSON زیر یک تصویر با متن جایگزین ایجاد می کند: 

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}
decoratedText

DecoratedText

یک مورد متن تزئین شده را نمایش می دهد.

به عنوان مثال، JSON زیر یک ویجت متن تزئین شده ایجاد می کند که آدرس ایمیل را نشان می دهد: 

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}
buttonList

ButtonList

لیستی از دکمه ها

به عنوان مثال، JSON زیر دو دکمه ایجاد می کند. اولی یک دکمه متن آبی و دومی یک دکمه تصویر است که یک پیوند را باز می کند: 

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
textInput

TextInput

کادر متنی را نمایش می دهد که کاربران می توانند در آن تایپ کنند.

به عنوان مثال، JSON زیر یک ورودی متنی برای آدرس ایمیل ایجاد می کند: 

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

به عنوان مثال دیگری، JSON زیر یک ورودی متنی برای یک زبان برنامه نویسی با پیشنهادات ثابت ایجاد می کند: 

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
selectionInput

SelectionInput

یک کنترل انتخاب را نمایش می دهد که به کاربران امکان می دهد موارد را انتخاب کنند. کنترل‌های انتخاب می‌توانند چک باکس، دکمه‌های رادیویی، سوئیچ‌ها یا منوهای کشویی باشند.

به عنوان مثال، JSON زیر یک منوی کشویی ایجاد می کند که به کاربران امکان می دهد اندازه ای را انتخاب کنند: 

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}
dateTimePicker

DateTimePicker

ویجتی را نمایش می دهد که به کاربران امکان می دهد تاریخ، زمان یا تاریخ و زمان را وارد کنند.

برای مثال، JSON زیر یک انتخابگر زمان برای زمان‌بندی قرار ایجاد می‌کند: 

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": "796435200000"
}
divider

Divider

یک تقسیم کننده خط افقی بین ویجت ها را نمایش می دهد.

به عنوان مثال، JSON زیر یک تقسیم کننده ایجاد می کند: 

"divider": {
}
grid

Grid

شبکه ای را با مجموعه ای از آیتم ها نمایش می دهد.

یک شبکه از هر تعداد ستون و آیتم پشتیبانی می کند. تعداد سطرها با کران های بالای آیتم های عددی تقسیم بر تعداد ستون ها تعیین می شود. یک شبکه با 10 مورد و 2 ستون دارای 5 ردیف است. یک شبکه با 11 مورد و 2 ستون دارای 6 ردیف است.

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

به عنوان مثال، JSON زیر یک شبکه 2 ستونی با یک آیتم ایجاد می کند: 

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
columns

Columns

حداکثر 2 ستون را نمایش می دهد.

برای گنجاندن بیش از 2 ستون یا استفاده از سطرها، از ویجت Grid استفاده کنید.

به عنوان مثال، JSON زیر 2 ستون ایجاد می کند که هر کدام شامل پاراگراف های متنی است: 

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}
chipList

ChipList

لیستی از چیپس ها

به عنوان مثال، JSON زیر دو تراشه ایجاد می کند. اولی یک تراشه متنی و دومی یک تراشه نماد است که پیوندی را باز می کند: 

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

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

تراز افقی

تعیین می کند که آیا ویجت ها در سمت چپ، راست یا مرکز یک ستون تراز شوند.

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

Enums
HORIZONTAL_ALIGNMENT_UNSPECIFIED استفاده نکنید. نامشخص
START مقدار پیش فرض ویجت ها را با موقعیت شروع ستون تراز می کند. برای طرح‌بندی‌های چپ به راست، به سمت چپ تراز کنید. برای طرح‌بندی‌های راست به چپ، به راست تراز کنید.
CENTER ویجت ها را با مرکز ستون تراز می کند.
END ویجت ها را با موقعیت انتهایی ستون تراز می کند. برای طرح‌بندی‌های چپ به راست، ویجت‌ها را به سمت راست تراز می‌کند. برای طرح‌بندی‌های راست به چپ، ویجت‌ها را در سمت چپ تراز می‌کند.

ImageType

شکلی که برای برش تصویر استفاده می شود.

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

Enums
SQUARE مقدار پیش فرض یک ماسک مربعی روی تصویر اعمال می کند. به عنوان مثال، یک تصویر 4x3 تبدیل به 3x3 می شود.
CIRCLE ماسک دایره ای را روی تصویر اعمال می کند. به عنوان مثال، یک تصویر 4x3 به دایره ای با قطر 3 تبدیل می شود.