البطاقة
البطاقة هي عنصر في واجهة المستخدم يمكن أن يحتوي على تطبيقات مصغّرة لواجهة المستخدم مثل النصوص والصور.
تمثيل JSON |
---|
{ "header": { object ( |
الحقول | |
---|---|
header
|
عنوان البطاقة. يحتوي العنوان عادةً على عنوان وصورة. |
sections[]
|
يتم فصل الأقسام بمقسّم خط. |
cardActions[]
|
إجراءات هذه البطاقة. |
name
|
اسم البطاقة |
CardHeader
تمثيل JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
الحقول | |
---|---|
title
|
يجب تحديد العنوان. يتميز العنوان بارتفاع ثابت: إذا تم تحديد كل من العنوان والعنوان الفرعي، يشغل كل منهما سطرًا واحدًا. إذا تم تحديد العنوان فقط، سيَشغل كلا السطرين. |
subtitle
|
العنوان الفرعي لرأس البطاقة. |
imageStyle
|
نوع الصورة (على سبيل المثال، حد مربّع أو حد دائري). |
imageUrl
|
عنوان URL للصورة في عنوان البطاقة |
ImageStyle
عمليات التعداد | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
حد مربع |
AVATAR
|
حد دائري |
القسم
يحتوي القسم على مجموعة من التطبيقات المصغّرة المعروضة (رأسيًا) بالترتيب الذي تم تحديدها. يكون عرض البطاقات ثابتًا وضيقًا في جميع الأنظمة الأساسية، وبالتالي ليست هناك حاجة في الوقت الحالي إلى استخدام خصائص التنسيق (على سبيل المثال، عدد عائم).
تمثيل JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
الحقول | |
---|---|
header
|
تمثّل هذه السمة عنوان القسم. يتوفر النص المنسّق. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على القسم تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
widgets[]
|
يجب أن يحتوي القسم على أداة واحدة على الأقل. |
WidgetMarkup
التطبيق المصغّر هو عنصر في واجهة المستخدم يعرض نصًا وصورًا.
تمثيل JSON |
---|
{ "buttons": [ { object ( |
الحقول | |
---|---|
buttons[]
|
قائمة بالأزرار. الأزرار أيضًا هي
|
حقل الاتحاد
data . يمكن أن تتضمن السمة WidgetMarkup عنصرًا واحدًا فقط من العناصر التالية. يمكنك استخدام عدّة حقول WidgetMarkup
لعرض المزيد من العناصر.
يمكن أن تكون السمة data واحدًا فقط مما يلي:
|
|
textParagraph
|
عرض فقرة نصية في هذا التطبيق المصغّر |
image
|
عرض صورة في هذا التطبيق المصغّر |
keyValue
|
عرض عنصر ذي قيمة رئيسية في هذا التطبيق المصغّر |
TextParagraph
فقرة من النص يتم دعم النص المنسّق. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على القسم تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace.
تمثيل JSON |
---|
{ "text": string } |
الحقول | |
---|---|
text
|
|
صورة
تمثّل هذه السمة صورة يتم تحديدها من خلال عنوان URL ويمكن أن تتضمّن الإجراء onclick
.
تمثيل JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
الحقول | |
---|---|
imageUrl
|
عنوان URL للصورة |
onClick
|
الإجراء
|
aspectRatio
|
نسبة العرض إلى الارتفاع لهذه الصورة (العرض والارتفاع). يتيح لك هذا الحقل حجز الارتفاع المناسب للصورة أثناء انتظار تحميلها. وليس الغرض منه إلغاء نسبة العرض إلى الارتفاع المضمنة في الصورة. في حال ترك هذه السياسة بدون ضبط، يملأها الخادم من خلال الجلب المُسبَق للصورة. |
OnClick
إجراء
onclick
(على سبيل المثال، فتح رابط)
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
يمكن أن تكون السمة |
|
action
|
يتم تشغيل إجراء النموذج من خلال إجراء
|
openLink
|
يؤدّي هذا الإجراء |
FormAction
يصف إجراء النموذج السلوك عند إرسال النموذج. على سبيل المثال، يمكنك استدعاء لغة "برمجة تطبيقات Google" لمعالجة النموذج.
تمثيل JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
الحقول | |
---|---|
actionMethodName
|
يُستخدَم اسم الطريقة لتحديد الجزء الذي أدّى إلى إرسال النموذج من النموذج. يتم إرجاع هذه المعلومات إلى تطبيق Chat كجزء من حدث النقر على البطاقة. يمكنك استخدام اسم الطريقة نفسه للعديد من العناصر التي تؤدي إلى سلوك شائع. |
parameters[]
|
قائمة مَعلمات الإجراءات |
ActionParameter
قائمة مَعلمات السلسلة المطلوب توفيرها عند استدعاء طريقة الإجراء. على سبيل المثال، يمكنك استخدام ثلاثة أزرار للتأجيل: تأجيل الآن، وتأجيل يوم واحد، وتأجيل الأسبوع التالي. يمكنك استخدام
action method = snooze()
، مع ضبط نوع التأجيل ووقت التأجيل في قائمة مَعلمات السلسلة.
تمثيل JSON |
---|
{ "key": string, "value": string } |
الحقول | |
---|---|
key
|
اسم مَعلمة النص البرمجي للإجراء. |
value
|
قيمة المَعلمة. |
OpenLink
رابط يفتح نافذة جديدة.
تمثيل JSON |
---|
{ "url": string } |
الحقول | |
---|---|
url
|
عنوان URL المطلوب فتحه. |
KeyValue
يحتوي عنصر واجهة مستخدم على مفتاح (تصنيف) وقيمة (محتوى). ويمكن أن يحتوي هذا العنصر أيضًا على بعض الإجراءات، مثل الزر onclick
.
تمثيل JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
الحقول | |
---|---|
topLabel
|
نص التصنيف العلوي. يتم دعم النص المنسّق. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على القسم تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
content
|
نص المحتوى. النص المنسّق متوافق ومطلوب دائمًا. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على القسم تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
contentMultiline
|
إذا كان يجب أن يكون المحتوى متعدد الأسطر. |
bottomLabel
|
نص التصنيف السفلي. يتم دعم النص المنسّق. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على القسم تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
onClick
|
الإجراء
|
حقل الاتحاد
icons . يجب تحديد رمز واحد على الأقل من الرموز، مثل top_label وbottom_label .
يمكن أن تكون السمة icons واحدًا فقط مما يلي:
|
|
icon
|
قيمة تعداد يتم استبدالها بصورة الرمز المقابلة في Chat API |
iconUrl
|
الرمز المحدد بواسطة عنوان URL. |
حقل الاتحاد
control . أداة تحكُّم يمكنك ضبط إما button أو switch_widget ، ولكن لا يمكن ضبط الاثنين معًا.
يمكن أن تكون السمة control واحدًا فقط مما يلي:
|
|
button
|
زر يمكن النقر عليه لتشغيل إجراء معيّن. |
الرمز
مجموعة الرموز المتوافقة.
عمليات التعداد | |
---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
زرّ
زر. يمكن أن يكون زرًا نصيًا أو زر صورة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
يمكن أن تكون السمة |
|
textButton
|
زر يحتوي على نص
والإجراء |
imageButton
|
زر يتضمّن صورة
والإجراء |
TextButton
زر يحتوي على نص
والإجراء onclick
.
تمثيل JSON |
---|
{
"text": string,
"onClick": {
object (
|
الحقول | |
---|---|
text
|
النص المكتوب على الزر. |
onClick
|
تمثّل هذه الخاصية الإجراء |
ImageButton
زر صورة مع إجراء
onclick
تمثيل JSON |
---|
{ "onClick": { object ( |
الحقول | |
---|---|
onClick
|
الإجراء
|
name
|
تمثّل هذه السمة اسم
|
حقل الاتحاد
icons . يمكن تحديد الرمز باستخدام
Icon
enum
أو عنوان URL.
يمكن أن تكون السمة icons واحدًا فقط مما يلي:
|
|
icon
|
يشير هذا الرمز إلى الرمز المحدّد من خلال |
iconUrl
|
الرمز المحدد بواسطة عنوان URL. |
CardAction
إجراء البطاقة هو الإجراء المرتبط بالبطاقة. بالنسبة إلى بطاقة فاتورة، قد يكون الإجراء المعتاد هو حذف الفاتورة أو حذفها عبر البريد الإلكتروني أو فتح الفاتورة في المتصفّح.
لا تتوافق مع تطبيقات Google Chat.
تمثيل JSON |
---|
{
"actionLabel": string,
"onClick": {
object (
|
الحقول | |
---|---|
actionLabel
|
التصنيف المستخدَم للعرض في عنصر قائمة الإجراءات |
onClick
|
إجراء النقر على عنصر العمل هذا. |