بطاقة
البطاقة هي عنصر واجهة مستخدِم يمكن أن يحتوي على تطبيقات مصغّرة لواجهة المستخدِم، مثل النصوص والصور.
تمثيل JSON |
---|
{ "header": { object ( |
الحقول | |
---|---|
header
|
عنوان البطاقة يحتوي العنوان عادةً على عنوان وصورة. |
sections[]
|
يتم فصل الأقسام بفاصل سطر. |
card
|
إجراءات هذه البطاقة |
name
|
اسم البطاقة |
CardHeader
تمثيل JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum ( |
الحقول | |
---|---|
title
|
يجب تحديد العنوان. العنوان له ارتفاع ثابت: إذا تم تحديد كل من العنوان والعنوان الفرعي، فيتم تشغل كل منهما سطرًا واحدًا. إذا تم تحديد العنوان فقط، سيشغل كلا السطرين. |
subtitle
|
العنوان الفرعي لرأس البطاقة |
image
|
نوع الصورة (على سبيل المثال، حدود مربّعة أو حدود دائرية) |
image
|
عنوان URL للصورة في عنوان البطاقة |
ImageStyle
عمليات التعداد | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
حدود مربّعة |
AVATAR
|
حد دائري |
القسم
يحتوي القسم على مجموعة من الأدوات التي يتم عرضها (عموديًا) بالترتيب الذي تم تحديدها به. على جميع الأنظمة الأساسية، يكون عرض البطاقات ضيّقًا وثابتًا، لذلك ليست هناك حاجة حاليًا إلى خصائص التنسيق (على سبيل المثال، العدد العائم).
تمثيل JSON |
---|
{
"header": string,
"widgets": [
{
object ( |
الحقول | |
---|---|
header
|
عنوان القسم يُسمح باستخدام النص المنسَّق. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على مقالتَي: تنسيق النص في تطبيقات Google Chat و تنسيق النص في إضافات Google Workspace. |
widgets[]
|
يجب أن يحتوي القسم على تطبيق مصغّر واحد على الأقل. |
WidgetMarkup
الأداة هي عنصر في واجهة المستخدم يعرض النصوص والصور.
تمثيل JSON |
---|
{ "buttons": [ { object ( |
الحقول | |
---|---|
buttons[]
|
قائمة بالأزرار يجب أيضًا ضبط حقل Buttons على
|
حقل الربط
data . ويمكن أن تحتوي
WidgetMarkup
على عنصر واحد فقط من العناصر التالية. ويمكنك استخدام عدة حقول WidgetMarkup لعرض المزيد من العناصر.
يمكن أن تكون القيمة data واحدًا فقط مما يلي:
|
|
text
|
عرض فقرة نصية في هذا التطبيق المصغّر |
image
|
يمكنك عرض صورة في هذا التطبيق المصغّر. |
key
|
عرض عنصر مفتاح/قيمة في هذه الأداة المصغّرة |
TextParagraph
فقرة من النص. النص المنسّق مسموح به. لمزيد من المعلومات عن تنسيق النصوص، يُرجى الاطّلاع على مقالتَي تنسيق النصوص في تطبيقات Google Chat وتنسيق النصوص في إضافات Google Workspace.
تمثيل JSON |
---|
{ "text": string } |
الحقول | |
---|---|
text
|
|
صورة
صورة يتم تحديدها من خلال عنوان URL ويمكن أن تتضمن إجراء onclick
.
تمثيل JSON |
---|
{
"imageUrl": string,
"onClick": {
object ( |
الحقول | |
---|---|
image
|
عنوان URL للصورة |
on
|
الإجراء
|
aspect
|
نسبة العرض إلى الارتفاع لهذه الصورة (العرض والارتفاع). يتيح لك هذا الحقل الاحتفاظ بالارتفاع المناسب للصورة أثناء انتظار تحميلها. ولا يهدف إلى إلغاء نسبة العرض إلى الارتفاع المضمّنة في الصورة. في حال عدم ضبطها، سيملؤها الخادم من خلال التحميل المُسبَق للصورة. |
OnClick
إجراء onclick
(على سبيل المثال، فتح رابط).
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
|
|
action
|
يتم تشغيل إجراء نموذج من خلال إجراء |
open
|
يؤدي هذا الإجراء
|
FormAction
يصف إجراء النموذج السلوك عند إرسال النموذج. على سبيل المثال، يمكنك استدعاء Apps Script لمعالجة النموذج.
تمثيل JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object ( |
الحقول | |
---|---|
action
|
يتم استخدام اسم الطريقة لتحديد أي جزء من النموذج أدّى إلى إرسال النموذج. يتم تكرار هذه المعلومات في تطبيق 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 ( |
الحقول | |
---|---|
top
|
نص التصنيف العلوي يمكن استخدام النص المنسَّق. لمزيد من المعلومات حول تنسيق النص، يمكنك الاطّلاع على تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
content
|
نص المحتوى يكون النص المنسّق متوافقًا ومطلوبًا دائمًا. لمزيد من المعلومات حول تنسيق النص، يمكنك الاطّلاع على تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
content
|
ما إذا كان يجب أن يكون المحتوى متعدد الأسطر. |
bottom
|
نص التصنيف السفلي. يمكن استخدام النص المنسَّق. لمزيد من المعلومات حول تنسيق النص، يمكنك الاطّلاع على تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
on
|
الإجراء
|
حقل الربط
icons . يجب تحديد رمز واحد على الأقل من top_label
وbottom_label
icons
يمكن أن تكون إحدى القيم التالية فقط:
|
|
icon
|
قيمة مصنّفة تم استبدالها من خلال Chat API بصورة الرمز المعنيّ. |
icon
|
هو الرمز الذي يتم تحديده من خلال عنوان 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 |
الحقول | |
---|---|
حقل الربط
يمكن أن تكون القيمة |
|
text
|
زر يحتوي على نص و |
image
|
زر مع صورة وإجراء |
TextButton
زر يحتوي على نص وإجراء
onclick
.
تمثيل JSON |
---|
{
"text": string,
"onClick": {
object ( |
الحقول | |
---|---|
text
|
النص المكتوب على الزر. |
on
|
الإجراء
|
ImageButton
زر صورة مع إجراء onclick
.
تمثيل JSON |
---|
{ "onClick": { object ( |
الحقول | |
---|---|
on
|
الإجراء
|
name
|
تمثّل هذه السمة اسم |
حقل الربط
icons . يمكن تحديد الرمز باستخدام Icon
enum
أو عنوان URL.
icons
يمكن أن تكون إحدى القيم التالية فقط:
|
|
icon
|
هو الرمز الذي يتم تحديده من خلال
|
icon
|
الرمز المحدّد من خلال عنوان URL |
CardAction
إجراء البطاقة هو الإجراء المرتبط بالبطاقة. بالنسبة إلى بطاقة فاتورة، سيكون الإجراء المعتاد هو: حذف الفاتورة أو إرسالها بالبريد الإلكتروني أو فتحها في المتصفّح.
لا تتوفّر هذه الميزة في تطبيقات Google Chat.
تمثيل JSON |
---|
{
"actionLabel": string,
"onClick": {
object ( |
الحقول | |
---|---|
action
|
كان التصنيف يظهر في عنصر قائمة الإجراءات. |
on
|
إجراء JSON لبند العمل هذا. |