Card Service

خدمة البطاقات

تسمح هذه الخدمة للنصوص البرمجية بضبط مكونات البطاقة والتطبيق المصغّر وسلوكياتهما وإنشاءها لواجهة المستخدم. إنّ تصاميم واجهة المستخدم التي تنشئها باستخدام هذه الخدمة تتوفّر تلقائيًا على كلّ من أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة، لذا لا تحتاج إلى تطوير واجهات مستخدم منفصلة لكلا الجهازَين.

صفوف

الاسموصف قصير
Actionإجراء يتيح التفاعل داخل عناصر واجهة المستخدم
ActionResponseعنصر الاستجابة الذي يمكن إرجاعه من دالة ردّ اتصال (مثل معالِج استجابة النموذج) لتنفيذ إجراء واحد أو أكثر على العميل
ActionResponseBuilderأداة إنشاء لكائنات ActionResponse
ActionStatusفئة تمثّل حالة طلب استدعاء مربّع حوار أو إرساله
Attachmentيمثّل مرفقًا أنشأته إضافة.
AuthorizationActionإجراء تفويض يوجّه المستخدم إلى AuthorizationUrl عند النقر عليه.
AuthorizationExceptionخطأ يمكن إرجاعه لعرض بطاقة تحصيل الرسوم للمستخدِم.
BorderStyleفئة تمثّل نمط حدود كاملاً يمكن تطبيقه على التطبيقات المصغّرة.
BorderTypeفهرس يمثّل أنواع الحدود التي يمكن تطبيقها على التطبيقات المصغّرة
Buttonفئة أساسية لجميع الأزرار
ButtonSetتحتوي على مجموعة من Button عناصر يتم عرضها في صف.
CalendarEventActionResponseيمثّل ردًا يؤدي إلى إجراء تغييرات على حدث التقويم الذي يعدّله المستخدم حاليًا كردّ فعل على إجراء تم اتخاذه في واجهة المستخدم، مثل النقر على زر.
CalendarEventActionResponseBuilderأداة إنشاء لكائنات CalendarEventActionResponse
Cardبطاقة سياق تمثّل عرضًا واحدًا في واجهة المستخدِم
CardActionعنصر قائمة يمكن النقر عليه تتم إضافته إلى قائمة عنوان البطاقة.
CardBuilderأداة إنشاء لكائنات Card
CardHeaderعنوان Card
CardSectionيتضمّن قسم البطاقة مجموعات من التطبيقات المصغّرة ويوفّر فصلاً مرئيًا بينها.
CardServiceتوفّر CardService إمكانية إنشاء بطاقات عامة تُستخدَم في منتجات Google القابلة للتوسيع المختلفة، مثل ملحقات Google Workspace.
CardWithIdأداة إنشاء لكائنات CardWithId
ChatActionResponseفئة تمثّل المَعلمات التي يمكن لتطبيق Chat استخدامها لضبط كيفية posted ردّه.
ChatClientDataSourceبالنسبة إلى تطبيق مصغّر SelectionInput يستخدم قائمة اختيار متعدّد، يجب توفير مصدر بيانات من Google Chat.
ChatResponseعنصر الردّ على رسالة بطاقة في Google Chat
ChatResponseBuilderأداة إنشاء لكائنات ChatResponse
ChatSpaceDataSourceمصدر بيانات يعبّئ مساحات Google Chat كعناصر اختيار لقائمة اختيار متعدّد
ChipChip مع رمز ونص
ChipListيحتوي على مجموعة من Chip عناصر يتم عرضها في صف، ويتم لفها إلى السطر التالي لتكون قابلة للانتقال أفقيًا.
ChipListLayoutعنصر مصنّف يحدّد تنسيق ChipList.
CollapseControlعنصر تحكّم قابل للتخصيص لتصغير المحتوى أو توسيعه
Columnعمود
Columnsتعرِض الأداة المصغّرة Columns ما يصل إلى عمودَين في بطاقة أو مربّع حوار.
CommonDataSourceمصدر بيانات تتم مشاركته من خلال جميع تطبيقات Google Workspace
ComposeActionResponseعنصر الاستجابة الذي قد يتم إرجاعه من طريقة طلب معاودة الاتصال لإجراء الإنشاء في إضافة Gmail.
ComposeActionResponseBuilderأداة إنشاء لكائنات ComposeActionResponse
ComposedEmailTypeقيمة مصنّفة تحدد ما إذا كانت الرسالة الإلكترونية التي تم إنشاؤها مستقلة أو مسودة ردّ.
ContentTypeقيمة مصنّفة تحدد نوع المحتوى الذي تم إنشاؤه بواسطة UpdateDraftActionResponse.
DatePickerحقل إدخال يسمح بإدخال تاريخ
DateTimePickerحقل إدخال يسمح للمستخدمين بإدخال تاريخ ووقت
DecoratedTextتطبيق مصغّر يعرض نصًا مع زخارف اختيارية
Dialogلمعرفة التفاصيل، يُرجى الاطّلاع على فتح حوارات interactive في مستندات Google Chat.
DialogActionأداة إنشاء لكائنات DialogAction
DisplayStyleفهرس يحدّد نمط عرض البطاقة.
Dividerخط فاصل أفقي
DriveItemsSelectedActionResponseيمثّل ردًا يُجري تغييرات على Drive أثناء اختيار عناصر Drive ونتيجةً لإجراء تم اتّخاذه في واجهة المستخدم، مثل النقر على زر.
DriveItemsSelectedActionResponseBuilderأداة إنشاء لكائنات DriveItemsSelectedActionResponse
EditorFileScopeActionResponseإجراء تغييرات على محرِّر، مثل "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" استجابةً لإجراء تم اتّخاذه في واجهة المستخدم
EditorFileScopeActionResponseBuilderأداة إنشاء لكائنات EditorFileScopeActionResponse
FixedFooterالتذييل الثابت الذي يظهر في أسفل Card
Gridشبكة منظَّمة لعرض مجموعة من عناصر الشبكة
GridItemالعناصر التي يتفاعل معها المستخدمون ضمن تطبيق مصغّر للشبكة
GridItemLayoutفهرس يحدِّد نمط الصورة والنص لعنصر GridItem
HorizontalAlignmentعنصر مصنّف يحدّد المحاذاة الأفقية لأداة مصغّرة.
HorizontalSizeStyleفهرس يحدّد كيفية ملء التطبيقات المصغّرة لمساحة عمود
HostAppDataSourceبالنسبة إلى تطبيق مصغّر SelectionInput يستخدم قائمة اختيار متعدّد، يجب توفير مصدر بيانات من تطبيق Workspace.
Iconرموز محدّدة مسبقًا يمكن استخدامها في عناصر مختلفة لواجهة المستخدم، مثل التطبيقات المصغّرة ImageButton أو DecoratedText
IconImageرمز محدّد مسبقًا أو رمز تصميم المواد أو رمز من عنوان URL مع نمط اقتصاص قابل للتخصيص
Imageتطبيق مصغّر يعرض صورة واحدة
ImageButtonImageButton مع صورة معروضة عليه
ImageButtonStyleعنصر مصنّف يحدّد تنسيق ImageButton.
ImageComponentعنصر صورة يمكن إضافته إلى عناصر الشبكة
ImageCropStyleفئة تمثّل نمط اقتصاص يمكن تطبيقه على مكونات الصورة.
ImageCropTypeعنصر مصنّف يمثّل أنماط الاقتصاص المطبَّقة على مكونات الصور.
ImageStyleعنصر مصنّف يحدّد نمط اقتصاص الصورة.
InputTypeفهرس يحدّد نوع إدخال التطبيق المصغّر
Interactionنوع مصنّف يحدّد الإجراء الذي يجب اتّخاذه استجابةً للتفاعل مع مستخدم، مثل نقره على زر في رسالة بطاقة.
KeyValueتم إيقاف هذه الفئة نهائيًا.
LinkPreviewإجراء البطاقة الذي يعرض بطاقة معاينة الرابط وشريحة ذكية في التطبيق المضيف
LoadIndicatorنوع مصنّف يحدّد نوع مؤشر التحميل أو التقدّم الذي سيتم عرضه أثناء معالجة Action.
MaterialIconعنصر يتوافق مع جميع رموز Google Fonts
Navigationعنصر مساعد يتحكّم في التنقّل في البطاقة
Notificationإشعار يُعرَض للمستخدم استجابةً للتفاعل مع عنصر واجهة مستخدم.
OnCloseفهرس يحدّد الإجراء الذي يجب اتّخاذه عند إغلاق عنوان URL تم فتحه من خلال OpenLink
OpenAsفهرس يحدّد كيفية فتح عنوان URL
OpenLinkيمثّل إجراءً لفتح رابط مع بعض الخيارات.
OverflowMenuيحتوي على قائمة بعناصر OverflowMenuItem التي يتم عرضها في قائمة منبثقة.
OverflowMenuItemOverflowMenuItem مع رمز ونص
PlatformDataSourceبالنسبة إلى تطبيق مصغّر SelectionInput يستخدم قائمة اختيار متعدّد، يجب أن يكون مصدر البيانات من Google Workspace.
ResponseTypeفهرس يمثّل نوع ردّ تطبيق Chat.
SelectionInputحقل إدخال يسمح بالاختيار من بين مجموعة من الخيارات المحدّدة مسبقًا
SelectionInputTypeتنسيق العناصر التي يمكن للمستخدمين اختيارها
Statusفهرس يمثّل رمز الحالة
Suggestionsاقتراحات للإكمال التلقائي لإكمال تطبيق مصغّر TextInput
SuggestionsResponseعنصر ردّ يمكن إرجاعه من دالة ردّ اتصال للاقتراحات
SuggestionsResponseBuilderأداة إنشاء لكائنات SuggestionsResponse
Switchعنصر واجهة مستخدِم يتيح تفعيله أو إيقافه
SwitchControlTypeنوع عنصر التحكّم في التطبيق المصغّر Switch.
TextButtonTextButton يتضمّن تصنيفًا نصيًا
TextButtonStyleعنصر مصنّف يحدّد تنسيق TextButton.
TextInputأداة حقل إدخال تقبل إدخال نص
TextParagraphأداة تعرض نصًا وتتوافق مع تنسيق HTML الأساسي
TimePickerحقل إدخال يسمح للمستخدمين بإدخال وقت
UniversalActionResponseعنصر الاستجابة الذي قد يتم إرجاعه من طريقة تنشئ إجراءً عامًا.
UniversalActionResponseBuilderأداة إنشاء لكائنات UniversalActionResponse
UpdateDraftActionResponseيمثّل إجراءً يعدّل مسودة الرسالة الإلكترونية التي يعدّلها المستخدم حاليًا.
UpdateDraftActionResponseBuilderأداة إنشاء لكائنات UpdateDraftActionResponse
UpdateDraftBccRecipientsActionتعديل مستلمي نسخة مخفية الوجهة لرسالة إلكترونية مسودة
UpdateDraftBodyActionتعديل نص مسودة الرسالة الإلكترونية
UpdateDraftBodyTypeقيمة مصنّفة تحدّد نوع UpdateDraftBodyAction.
UpdateDraftCcRecipientsActionتعديل مستلمي نسخة من مسودة رسالة إلكترونية
UpdateDraftSubjectActionتعديل سطر موضوع مسودة رسالة إلكترونية
UpdateDraftToRecipientsActionتعديل مستلمي "إلى" مسودة رسالة إلكترونية
UpdatedWidgetاستجابة التطبيق المصغّر المعدَّل.
Validationعنصر يحدّد قاعدة التحقّق من الصحة للتطبيق المصغّر المُرفَق به.
VerticalAlignmentفهرس يحدّد المحاذاة العمودية للتطبيقات المصغّرة في عمود
Widgetفئة أساسية لجميع التطبيقات المصغّرة التي يمكن إضافتها إلى Card.
WrapStyleفهرس يحدّد نمط التفاف المحتوى ضمن عمود

Action

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addRequiredWidget(requiredWidget)Actionتُضيف أسماء التطبيقات المصغّرة التي يحتاج إليها هذا الإجراء لإرسال بيانات صالحة.
setAllWidgetsAreRequired(allWidgetsAreRequired)Actionيشير إلى ما إذا كان هذا الإجراء يتطلّب إدخالات من جميع التطبيقات المصغّرة.
setFunctionName(functionName)Actionتُستخدَم لضبط اسم دالة ردّ الاتصال التي سيتمّ استدعاؤها.
setInteraction(interaction)Actionلضبط التفاعل مع المستخدِم، وهو مطلوب فقط عند فتح مربّع حوار.
setLoadIndicator(loadIndicator)Actionلضبط مؤشر التحميل الذي يظهر أثناء تنفيذ الإجراء
setParameters(parameters)Actionالسماح بتمرير مَعلمات مخصّصة إلى دالة ردّ الاتصال
setPersistValues(persistValues)Actionتشير إلى ما إذا كانت قيم النموذج يتم تحديدها حسب قيم العميل أو قيم الخادم بعد أن تعدّل استجابة إجراء Card النموذج.

ActionResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

ActionResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
build()ActionResponseتُنشئ هذه الوظيفة ردّ الإجراء الحالي وتتحقّق من صحته.
setNavigation(navigation)ActionResponseBuilderتُستخدَم لضبط الاستجابة للإجراء Navigation.
setNotification(notification)ActionResponseBuilderلضبط الإشعار لعرضه عند تفعيل الإجراء.
setOpenLink(openLink)ActionResponseBuilderتُستخدَم لضبط عنوان URL الذي يتم الانتقال إليه عند تفعيل الإجراء.
setStateChanged(stateChanged)ActionResponseBuilderتُستخدَم لضبط علامة للإشارة إلى أنّ هذا الإجراء قد غيّر حالة البيانات الحالية.

ActionStatus

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setStatusCode(statusCode)ActionStatusتمثّل حالة طلب فتح مربّع حوار أو إرساله.
setUserFacingMessage(message)ActionStatusالرسالة المُراد إرسالها إلى المستخدمين بشأن حالة طلبهم

Attachment

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setIconUrl(iconUrl)Attachmentتُستخدَم لضبط عنوان URL للرمز المرتبط بالمرفق.
setMimeType(mimeType)Attachmentلضبط نوع MIME للمرفق.
setResourceUrl(resourceUrl)Attachmentتُستخدَم لضبط عنوان URL للمورد المرتبط بالمرفق.
setTitle(title)Attachmentلضبط عنوان المرفق.

AuthorizationAction

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAuthorizationUrl(authorizationUrl)AuthorizationActionلضبط عنوان URL الخاص بالتفويض الذي يتم توجيه المستخدم إليه من طلب التفويض.

AuthorizationException

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.
setAuthorizationUrl(authUrl)AuthorizationExceptionلضبط عنوان URL الخاص بالتفويض الذي يتم توجيه المستخدم إليه من طلب التفويض.
setCustomUiCallback(callback)AuthorizationExceptionاسم دالة يتمّ استدعاؤها لإنشاء طلب إذن مخصّص.
setResourceDisplayName(name)AuthorizationExceptionلضبط الاسم الذي يظهر للمستخدم عند طلب التفويض.
throwException()voidيؤدي إلى طرح هذا الاستثناء.

BorderStyle

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setCornerRadius(radius)BorderStyleلضبط نصف قطر زاوية الحدود، على سبيل المثال 8
setStrokeColor(color)BorderStyleلضبط لون الحد.
setType(type)BorderStyleلضبط نوع الحدّ

BorderType

أماكن إقامة

الموقعالنوعالوصف
NO_BORDEREnumلا يتضمّن نمط حدود.
STROKEEnumنمط حدود ضغط المفاتيح

Button

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAuthorizationAction(action)Buttonتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setComposeAction(action, composedEmailType)Buttonتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setOnClickAction(action)Buttonتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)Buttonتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)Buttonتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.
setOverflowMenu(menu)Buttonلضبط قائمة منبثقة يتم فتحها عند النقر على العنصر.

ButtonSet

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addButton(button)ButtonSetتُضيف زرًا.

CalendarEventActionResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

CalendarEventActionResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addAttachments(attachments)CalendarEventActionResponseBuilderتُحدِّد هذه السمة أنّه يجب أن يضيف الردّ المرفقات إلى حدث "تقويم Google" عند تنفيذ الإجراء المرتبط بواجهة المستخدم.
addAttendees(emails)CalendarEventActionResponseBuilderيحدّد هذا العنصر أنّ الردّ يجب أن يضيف الضيوف المحدّدين إلى حدث "تقويم Google" عند تنفيذ الإجراء المرتبط بواجهة المستخدم.
build()CalendarEventActionResponseينشئ ردّ الإجراء الحالي لحدث "تقويم Google" ويتحقق منه.
setConferenceData(conferenceData)CalendarEventActionResponseBuilderتُحدِّد هذه السمة أنّه يجب ضبط الاستجابة لبيانات المؤتمر المُشار إليها على حدث "تقويم Google" عند اتّخاذ الإجراء المرتبط بواجهة المستخدم.

Card

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

CardAction

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAuthorizationAction(action)CardActionتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setComposeAction(action, composedEmailType)CardActionتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setOnClickAction(action)CardActionتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)CardActionتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)CardActionتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.
setText(text)CardActionلضبط نص القائمة لهذا الإجراء.

CardBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addCardAction(cardAction)CardBuilderتُضيف CardAction إلى هذه البطاقة.
addSection(section)CardBuilderتُضيف قسمًا إلى هذه البطاقة.
build()Cardإنشاء البطاقة الحالية والتحقّق منها
setDisplayStyle(displayStyle)CardBuilderلضبط نمط عرض هذه البطاقة.
setFixedFooter(fixedFooter)CardBuilderلضبط تذييل ثابت لهذه البطاقة.
setHeader(cardHeader)CardBuilderلضبط عنوان هذه البطاقة.
setName(name)CardBuilderلضبط اسم هذه البطاقة.
setPeekCardHeader(peekCardHeader)CardBuilderلضبط عنوان بطاقة "الاطّلاع السريع"

CardHeader

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setImageAltText(imageAltText)CardHeaderتُستخدَم لضبط النص البديل لصورة الرأس.
setImageStyle(imageStyle)CardHeaderلضبط اقتصاص الرمز في عنوان البطاقة.
setImageUrl(imageUrl)CardHeaderلضبط الصورة المراد استخدامها في العنوان من خلال تقديم عنوان URL أو سلسلة البيانات
setSubtitle(subtitle)CardHeaderلضبط العنوان الفرعي لعنوان البطاقة
setTitle(title)CardHeaderلضبط عنوان عنوان البطاقة.

CardSection

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addWidget(widget)CardSectionتُضيف هذه الوسيطة التطبيق المصغّر المحدّد إلى هذا القسم.
setCollapseControl(collapseControl)CardSectionتُستخدَم لضبط أزرار التوسيع والتصغير القابلة للتخصيص للقسم.
setCollapsible(collapsible)CardSectionلتحديد ما إذا كان يمكن تصغير القسم.
setHeader(header)CardSectionلضبط عنوان القسم
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionلتحديد عدد التطبيقات المصغّرة التي ستظل معروضة عند تصغير هذا القسم.

CardService

أماكن إقامة

الموقعالنوعالوصف
BorderTypeBorderTypeالتعداد BorderType
ChipListLayoutChipListLayoutالتعداد ChipListLayout
ComposedEmailTypeComposedEmailTypeالتعداد ComposedEmailType
ContentTypeContentTypeالتعداد ContentType
GridItemLayoutGridItemLayoutالتعداد GridItemLayout
HorizontalAlignmentHorizontalAlignmentالتعداد HorizontalAlignment
IconIconالتعداد Icon
ImageButtonStyleImageButtonStyleالتعداد ImageButtonStyle
ImageCropTypeImageCropTypeالتعداد ImageCropType
ImageStyleImageStyleالتعداد ImageStyle
InputTypeInputTypeالتعداد InputType
LoadIndicatorLoadIndicatorالتعداد LoadIndicator
OnCloseOnCloseالتعداد OnClose
OpenAsOpenAsالتعداد OpenAs
SelectionInputTypeSelectionInputTypeالتعداد SelectionInputType
TextButtonStyleTextButtonStyleالتعداد TextButtonStyle
UpdateDraftBodyTypeUpdateDraftBodyTypeالتعداد UpdateDraftBodyType

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
newAction()Actionلإنشاء Action جديد.
newActionResponseBuilder()ActionResponseBuilderلإنشاء ActionResponseBuilder جديد.
newActionStatus()ActionStatusلإنشاء ActionStatus جديد.
newAttachment()Attachmentلإنشاء Attachment جديد.
newAuthorizationAction()AuthorizationActionلإنشاء AuthorizationAction جديد.
newAuthorizationException()AuthorizationExceptionلإنشاء AuthorizationException جديد.
newBorderStyle()BorderStyleلإنشاء BorderStyle جديد.
newButtonSet()ButtonSetلإنشاء ButtonSet جديد.
newCalendarEventActionResponseBuilder()CalendarEventActionResponseBuilderلإنشاء CalendarEventActionResponseBuilder جديد.
newCardAction()CardActionلإنشاء CardAction جديد.
newCardBuilder()CardBuilderلإنشاء أداة إنشاء بطاقات جديدة
newCardHeader()CardHeaderلإنشاء CardHeader جديد.
newCardSection()CardSectionلإنشاء CardSection جديد.
newCardWithId()CardWithIdلإنشاء CardWithId جديد.
newChatActionResponse()ChatActionResponseلإنشاء ChatActionResponse جديد.
newChatResponseBuilder()ChatResponseBuilderلإنشاء ChatResponseBuilder جديد.
newChip()Chipلإنشاء Chip جديد.
newChipList()ChipListلإنشاء ChipList جديد.
newCollapseControl()CollapseControlلإنشاء CollapseControl جديد.
newColumn()Columnلإنشاء Column جديد.
newColumns()Columnsلإنشاء مجموعة جديدة من Columns.
newComposeActionResponseBuilder()ComposeActionResponseBuilderلإنشاء ComposeActionResponseBuilder جديد.
newDatePicker()DatePickerلإنشاء DatePicker جديد.
newDateTimePicker()DateTimePickerلإنشاء DateTimePicker جديد.
newDecoratedText()DecoratedTextلإنشاء DecoratedText جديد.
newDialog()Dialogلإنشاء Dialog جديد.
newDialogAction()DialogActionلإنشاء DialogAction جديد.
newDivider()Dividerلإنشاء Divider جديد.
newDriveItemsSelectedActionResponseBuilder()DriveItemsSelectedActionResponseBuilderلإنشاء DriveItemsSelectedActionResponseBuilder جديد.
newEditorFileScopeActionResponseBuilder()EditorFileScopeActionResponseBuilderلإنشاء EditorFileScopeActionResponseBuilder جديد.
newFixedFooter()FixedFooterلإنشاء FixedFooter جديد.
newGrid()Gridلإنشاء Grid جديد.
newGridItem()GridItemلإنشاء GridItem جديد.
newIconImage()IconImageلإنشاء IconImage جديد.
newImage()Imageلإنشاء Image جديد.
newImageButton()ImageButtonلإنشاء ImageButton جديد.
newImageComponent()ImageComponentلإنشاء ImageComponent جديد.
newImageCropStyle()ImageCropStyleلإنشاء ImageCropStyle جديد.
newKeyValue()KeyValueلإنشاء KeyValue جديد.
newLinkPreview()LinkPreviewلإنشاء LinkPreview جديد.
newMaterialIcon()MaterialIconلإنشاء MaterialIcon جديد.
newNavigation()Navigationلإنشاء Navigation جديد.
newNotification()Notificationلإنشاء Notification جديد.
newOpenLink()OpenLinkلإنشاء OpenLink جديد.
newOverflowMenu()OverflowMenuلإنشاء OverflowMenu جديد.
newOverflowMenuItem()OverflowMenuItemلإنشاء OverflowMenuItem جديد.
newSelectionInput()SelectionInputلإنشاء SelectionInput جديد.
newSuggestions()Suggestionsلإنشاء Suggestions جديد.
newSuggestionsResponseBuilder()SuggestionsResponseBuilderلإنشاء SuggestionsResponseBuilder جديد.
newSwitch()Switchلإنشاء Switch جديد.
newTextButton()TextButtonلإنشاء TextButton جديد.
newTextInput()TextInputلإنشاء TextInput جديد.
newTextParagraph()TextParagraphلإنشاء TextParagraph جديد.
newTimePicker()TimePickerلإنشاء TimePicker جديد.
newUniversalActionResponseBuilder()UniversalActionResponseBuilderلإنشاء UniversalActionResponseBuilder جديد.
newUpdateDraftActionResponseBuilder()UpdateDraftActionResponseBuilderلإنشاء UpdateDraftActionResponseBuilder جديد.
newUpdateDraftBccRecipientsAction()UpdateDraftBccRecipientsActionإنشاء UpdateDraftBccRecipientsAction جديد
newUpdateDraftBodyAction()UpdateDraftBodyActionلإنشاء UpdateDraftBodyAction جديد.
newUpdateDraftCcRecipientsAction()UpdateDraftCcRecipientsActionلإنشاء UpdateDraftCcRecipientsAction جديد.
newUpdateDraftSubjectAction()UpdateDraftSubjectActionلإنشاء UpdateDraftSubjectAction جديد.
newUpdateDraftToRecipientsAction()UpdateDraftToRecipientsActionلإنشاء UpdateDraftToRecipientsAction جديد.
newValidation()Validationلإنشاء Validation جديد.

CardWithId

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setCard(card)CardWithIdلضبط بطاقة cardWithId
setCardId(id)CardWithIdلضبط معرّف البطاقة الفريد cardWithId.

ChatActionResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setDialogAction(dialogAction)ChatActionResponseتعيين إجراء الحوار إلى حدث مرتبط بمربّع حوار
setResponseType(responseType)ChatActionResponseنوع ردّ تطبيق Chat
setUpdatedWidget(updatedWidget)ChatActionResponseتُستخدَم لضبط التطبيق المصغّر المعدَّل، والذي يقدّم خيارات الإكمال التلقائي لتطبيق مصغّر.
setUrl(url)ChatActionResponseعنوان URL الذي يمكن للمستخدمين استخدامه للمصادقة أو الضبط

ChatClientDataSource

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setSpaceDataSource(spaceDataSource)ChatClientDataSourceمصدر بيانات يعبّئ مساحات Google Chat كعناصر اختيار لقائمة اختيار متعدّد

ChatResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

ChatResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addCardsV2(cardWithId)ChatResponseBuilderلضبط حقل البطاقة في الرسالة.
build()ChatResponseتُنشئ هذه الوظيفة ردّ الإجراء الحالي وتتحقّق من صحته.
setActionResponse(actionResponse)ChatResponseBuilderتُستخدَم لضبط حقل الردّ على الإجراء في الرسالة.
setText(text)ChatResponseBuilderلضبط نص رسالة Chat

ChatSpaceDataSource

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setDefaultToCurrentSpace(defaultToCurrentSpace)ChatSpaceDataSourceفي حال ضبط القيمة على true، ستختار قائمة الاختيار المتعدّد مساحة Google Chat الحالية كعنصر تلقائيًا.

Chip

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAltText(altText)Chipلضبط النص البديل للشريحة من أجل تسهيل الاستخدام
setAuthorizationAction(action)Chipتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setComposeAction(action, composedEmailType)Chipتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setDisabled(disabled)Chipلضبط ما إذا كانت الشريحة غير مفعَّلة.
setIcon(icon)Chipلضبط الرمز الذي سيتم استخدامه كشريحة.
setLabel(label)Chipتُستخدَم لضبط عنوان الشريحة.
setOnClickAction(action)Chipتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)Chipتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)Chipتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.

ChipList

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addChip(chip)ChipListلإضافة شريحة
setLayout(layout)ChipListلضبط تنسيق قائمة الشرائح

ChipListLayout

أماكن إقامة

الموقعالنوعالوصف
WRAPPEDEnumيتم عرض قائمة الشرائح في السطر التالي إذا لم تكن هناك مساحة أفقية كافية.
HORIZONTAL_SCROLLABLEEnumيتم التمرير في الشرائح أفقيًا إذا لم تلائم المساحة المتوفّرة.

CollapseControl

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setCollapseButton(button)CollapseControlلضبط Button الذي يتم عرضه للزر "إظهار محتوى أقل".
setExpandButton(button)CollapseControlلضبط الرمز Button الذي يظهر على زر "عرض المزيد"
setHorizontalAlign(horizontalAlignment)CollapseControlتُستخدَم لضبط HorizontalAlignment في CollapseControl.

Column

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addWidget(widget)Columnتُضيف تطبيقًا مصغّرًا إلى العمود.
setHorizontalAlignment(horizontalAlignment)Columnتُستخدَم لضبط HorizontalAlignment في Column.
setHorizontalSizeStyle(horizontalSizeStyle)Columnلضبط HorizontalSizeStyle للعمود
setVerticalAlignment(verticalAlignment)Columnتُستخدَم لضبط VerticalAlignment في Column.

Columns

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addColumn(column)Columnsلإضافة Column إلى التطبيق المصغّر "الأعمدة"
setWrapStyle(wrapStyle)Columnsتُستخدَم لضبط نمط التفاف الأعمدة، كما تتحكّم في كيفية تغيير حجم العمود استنادًا إلى عرض الشاشة.

CommonDataSource

أماكن إقامة

الموقعالنوعالوصف
UNKNOWNEnumالقيمة التلقائية
USEREnumمستخدمو Google Workspace

ComposeActionResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

ComposeActionResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
build()ComposeActionResponseتُنشئ هذه الوظيفة ردّ الإجراء الحالي لإنشاء المحتوى وتُجري عملية التحقّق منه.
setGmailDraft(draft)ComposeActionResponseBuilderتُستخدَم لضبط مسودة GmailMessage التي تم إنشاؤها باستخدام GmailMessage.createDraftReply(body) أو دوالّ مشابهة.

ComposedEmailType

أماكن إقامة

الموقعالنوعالوصف
REPLY_AS_DRAFTEnumمسودة هي ردّ على رسالة أخرى
STANDALONE_DRAFTEnumمسودة هي رسالة مستقلة.

ContentType

أماكن إقامة

الموقعالنوعالوصف
TEXTEnumتشير إلى أنّ المحتوى الذي تم إنشاؤه هو نص عادي.
MUTABLE_HTMLEnumيشير إلى أنّ المحتوى الذي تم إنشاؤه منسَّق بتنسيق HTML.
IMMUTABLE_HTMLEnumيشير ذلك إلى أنّ المحتوى الذي تم إنشاؤه بتنسيق HTML، ولكن لا يمكن تعديله بعد إنشائه.

DatePicker

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setFieldName(fieldName)DatePickerتُستخدَم لضبط اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setOnChangeAction(action)DatePickerتُستخدَم لضبط Action ينفّذها النص البرمجي كلما تغيّرت إدخالات أداة الاختيار.
setTitle(title)DatePickerلضبط العنوان المعروض أعلى حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DatePickerلضبط القيمة المعبأة مسبقًا في حقل الإدخال
setValueInMsSinceEpoch(valueMsEpoch)DatePickerلضبط القيمة المعبأة مسبقًا في حقل الإدخال

DateTimePicker

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setFieldName(fieldName)DateTimePickerتُستخدَم لضبط اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setOnChangeAction(action)DateTimePickerتُستخدَم لضبط Action ينفّذها النص البرمجي كلما تغيّرت إدخالات أداة الاختيار.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerلضبط عدد الدقائق التي يجب أن تكون فيها المنطقة الزمنية مختلفة عن التوقيت العالمي المنسق.
setTitle(title)DateTimePickerلضبط العنوان المعروض أعلى حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerلضبط القيمة المعبأة مسبقًا في حقل الإدخال
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerلضبط القيمة المعبأة مسبقًا في حقل الإدخال

DecoratedText

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAuthorizationAction(action)DecoratedTextتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setBottomLabel(text)DecoratedTextلضبط نص التصنيف لاستخدامه كمفتاح، ويتم عرضه أسفل محتوى النص.
setButton(button)DecoratedTextلضبط Button الذي يظهر على يسار النص.
setComposeAction(action, composedEmailType)DecoratedTextتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setEndIcon(endIcon)DecoratedTextلضبط الرمز IconImage الاختياري الذي يظهر على يسار المحتوى
setOnClickAction(action)DecoratedTextتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)DecoratedTextتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)DecoratedTextتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.
setStartIcon(startIcon)DecoratedTextلضبط الرمز IconImage الاختياري لعرضه قبل محتوى النص
setSwitchControl(switchToSet)DecoratedTextلضبط Switch الذي يظهر على يسار المحتوى
setText(text)DecoratedTextلضبط النص الذي سيتم استخدامه كقيمة
setTopLabel(text)DecoratedTextلضبط نص التصنيف الذي سيتم استخدامه كمفتاح ويتم عرضه أعلى محتوى النص.
setWrapText(wrapText)DecoratedTextلضبط ما إذا كان يجب عرض نص القيمة على سطر واحد أو أسطر متعددة.

Dialog

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setBody(card)Dialogلضبط بطاقة Dialog

DialogAction

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setActionStatus(actionStatus)DialogActionتُستخدَم لضبط حالة الإجراء DialogAction.
setDialog(dialog)DialogActionلضبط مربّع حوار DialogAction.

DisplayStyle

أماكن إقامة

الموقعالنوعالوصف
PEEKEnumعرض عنوان البطاقة في أسفل المحتوى الإضافي فوق المحتوى الحالي
REPLACEEnumعرض البطاقة من خلال استبدال المحتوى الحالي

Divider

DriveItemsSelectedActionResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

DriveItemsSelectedActionResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
build()DriveItemsSelectedActionResponseلإنشاء ردّ على إجراء Drive الحالي
requestFileScope(itemId)DriveItemsSelectedActionResponseBuilderتشير إلى أنّ الاستجابة تطلب نطاق الملف للعنصر ذي الصلة بالسياق في Drive.

EditorFileScopeActionResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

EditorFileScopeActionResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
build()EditorFileScopeActionResponseتُنشئ استجابة إجراء "المحرِّر" الحالية.
requestFileScopeForActiveDocument()EditorFileScopeActionResponseBuilderتطلب نطاق drive.file لمستند المحرِّر النشط الحالي.

FixedFooter

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setPrimaryButton(button)FixedFooterاضبط الزر الأساسي في التذييل الثابت.
setSecondaryButton(button)FixedFooterاضبط الزر الثانوي في التذييل الثابت.

Grid

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addItem(gridItem)Gridتُضيف عنصر شبكة جديدًا إلى الشبكة.
setAuthorizationAction(action)Gridتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setBorderStyle(borderStyle)Gridلضبط نمط الحدود المطبَّق على كل عنصر في الشبكة
setComposeAction(action, composedEmailType)Gridتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setNumColumns(numColumns)Gridعدد الأعمدة المطلوب عرضها في الشبكة
setOnClickAction(action)Gridتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)Gridتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)Gridتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.
setTitle(title)Gridلضبط نص عنوان الشبكة

GridItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setIdentifier(id)GridItemلضبط معرّف عنصر الشبكة
setImage(image)GridItemلضبط صورة عنصر الشبكة هذا
setLayout(layout)GridItemلضبط تنسيق النص والصورة لعنصر الشبكة
setSubtitle(subtitle)GridItemلضبط العنوان الفرعي لعنصر الشبكة
setTextAlignment(alignment)GridItemلضبط المحاذاة الأفقية لعنصر الشبكة
setTitle(title)GridItemلضبط نص عنوان عنصر الشبكة

GridItemLayout

أماكن إقامة

الموقعالنوعالوصف
TEXT_BELOWEnumيظهر العنوان والعنوان الفرعي أسفل صورة عنصر الشبكة.
TEXT_ABOVEEnumيظهر العنوان والعنوان الفرعي أعلى صورة عنصر الشبكة.

HorizontalAlignment

أماكن إقامة

الموقعالنوعالوصف
STARTEnumمحاذاة التطبيق المصغّر مع بداية جانب الجملة
CENTEREnumمحاذاة التطبيق المصغّر في الوسط
ENDEnumمحاذاة التطبيق المصغّر مع نهاية جانب الجملة

HorizontalSizeStyle

أماكن إقامة

الموقعالنوعالوصف
FILL_AVAILABLE_SPACEEnumتُحدِّد حجم Widget لملء المساحة الأفقية المتاحة في Column.
FILL_MINIMUM_SPACEEnumيغيّر حجم Widget لملء أقل قدر من المساحة الأفقية في Column.

HostAppDataSource

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setChatDataSource(chatClientDataSource)HostAppDataSourceلضبط مصدر البيانات من Google Chat

Icon

أماكن إقامة

الموقعالنوعالوصف
NONEEnumلا يتوفّر رمز.
AIRPLANEEnumرمز رحلة جوية على متن طائرة
BOOKMARKEnumرمز الإشارة
BUSEnumرمز الحافلة
CAREnumرمز السيارة
CLOCKEnumرمز الساعة
CONFIRMATION_NUMBER_ICONEnumرمز رقم التأكيد
DOLLAREnumرمز الدولار
DESCRIPTIONEnumرمز الوصف
EMAILEnumرمز البريد الإلكتروني
EVENT_PERFORMEREnumرمز البريد الإلكتروني
EVENT_SEATEnumرمز مقعد في الفعالية
FLIGHT_ARRIVALEnumرمز وصول رحلة جوية
FLIGHT_DEPARTUREEnumرمز مغادرة الرحلة الجوية
HOTELEnumرمز الفندق
HOTEL_ROOM_TYPEEnumرمز الفندق
INVITEEnumرمز الدعوة
MAP_PINEnumرمز دبوس الخريطة
MEMBERSHIPEnumرمز الاشتراك الداعم
MULTIPLE_PEOPLEEnumرمز أشخاص متعدّدين
OFFEREnumرمز العرض
PERSONEnumرمز شخص
PHONEEnumرمز الهاتف
RESTAURANT_ICONEnumرمز المطعم
SHOPPING_CARTEnumرمز سلّة التسوّق
STAREnumرمز النجمة
STOREEnumرمز المتجر
TICKETEnumرمز التذكرة
TRAINEnumرمز القطار
VIDEO_CAMERAEnumرمز كاميرا الفيديو
VIDEO_PLAYEnumرمز تشغيل الفيديو

IconImage

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAltText(altText)IconImageلضبط النص البديل لعنوان URL الذي يتم استخدامه لتحسين إمكانية الوصول
setIcon(icon)IconImageتُحدّد الرمز المحدّد مسبقًا في حال عدم ضبط عنوان URL.
setIconUrl(url)IconImageتُستخدَم لضبط عنوان URL للرمز في حال عدم ضبطه.
setImageCropType(imageCropType)IconImageلضبط نمط الاقتصاص للصورة.
setMaterialIcon(icon)IconImageتُستخدَم لضبط رمز التصميم المتعدّد الأبعاد.

Image

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAltText(altText)Imageلضبط النص البديل للصورة لتسهيل الاستخدام
setAuthorizationAction(action)Imageتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setComposeAction(action, composedEmailType)Imageتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setImageUrl(url)Imageلضبط الصورة المطلوب استخدامها من خلال تقديم عنوان URL أو سلسلة البيانات
setOnClickAction(action)Imageتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)Imageتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)Imageتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.

ImageButton

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAltText(altText)ImageButtonتُستخدَم لضبط النص البديل للزر من أجل تسهيل الاستخدام.
setAuthorizationAction(action)ImageButtonتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setComposeAction(action, composedEmailType)ImageButtonتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setIcon(icon)ImageButtonلضبط رمز Icon محدّد مسبقًا لعرضه على الزر
setIconUrl(url)ImageButtonلضبط عنوان URL لصورة لاستخدامها كرمز لهذا الزر.
setImageButtonStyle(imageButtonStyle)ImageButtonلضبط نمط الزر
setMaterialIcon(icon)ImageButtonتُستخدَم لضبط رمز التصميم المتعدّد الأبعاد.
setOnClickAction(action)ImageButtonتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)ImageButtonتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)ImageButtonتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.
setOverflowMenu(menu)ImageButtonلضبط قائمة منبثقة يتم فتحها عند النقر على العنصر.

ImageButtonStyle

أماكن إقامة

الموقعالنوعالوصف
BORDERLESSEnumزر صورة بدون حدود
OUTLINEDEnumزر صورة بخلفية واضحة
FILLEDEnumزر صورة مع خلفية ملونة
FILLED_TONALEnumزر صورة يتضمّن خيارًا وسطًا بديلاً بين الأزرار الملونة والمخطّطة

ImageComponent

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAltText(altText)ImageComponentلضبط النص البديل للصورة
setBorderStyle(borderStyle)ImageComponentلضبط نمط الحدود المطبَّق على الصورة.
setCropStyle(imageCropStyle)ImageComponentلضبط نمط الاقتصاص للصورة.
setImageUrl(url)ImageComponentلضبط عنوان URL للصورة

ImageCropStyle

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAspectRatio(ratio)ImageCropStyleلضبط نسبة العرض إلى الارتفاع التي سيتم استخدامها إذا كان نوع الاقتصاص هو RECTANGLE_CUSTOM.
setImageCropType(type)ImageCropStyleلضبط نوع الاقتصاص للصورة.

ImageCropType

أماكن إقامة

الموقعالنوعالوصف
SQUAREEnumنمط اقتصاص مربّع الشكل
CIRCLEEnumنمط اقتصاص على شكل دائرة
RECTANGLE_CUSTOMEnumنمط اقتصاص مستطيل الشكل بنسبة مخصّصة
RECTANGLE_4_3Enumنمط اقتصاص مستطيل الشكل بنسبة عرض إلى ارتفاع 4:3

ImageStyle

أماكن إقامة

الموقعالنوعالوصف
SQUAREEnumبدون اقتصاص
CIRCLEEnumاقتصاص الصورة لتصبح على شكل دائرة

InputType

أماكن إقامة

الموقعالنوعالوصف
TEXTEnumقبول نص عادي
INTEGEREnumقبول عدد صحيح
FLOATEnumقبول عدد عشري
EMAILEnumقبول عنوان بريد إلكتروني

Interaction

أماكن إقامة

الموقعالنوعالوصف
INTERACTION_UNSPECIFIEDEnumالقيمة التلقائية
OPEN_DIALOGEnumيفتح مربّع حوار، وهو واجهة مستندة إلى البطاقات تستخدمها تطبيقات Chat للتفاعل مع المستخدمين.

KeyValue

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAuthorizationAction(action)KeyValueتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setComposeAction(action, composedEmailType)KeyValueتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setOnClickAction(action)KeyValueتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)KeyValueتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)KeyValueتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.

LinkPreview

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.
setLinkPreviewTitle(title)LinkPreviewلضبط العنوان الذي يظهر في معاينة الرابط أعلى بطاقة المعاينة.
setPreviewCard(previewCard)LinkPreviewلضبط البطاقة التي تعرض معلومات عن رابط من خدمة تابعة لجهة خارجية أو غير تابعة لشركة Google
setTitle(title)LinkPreviewلضبط العنوان الذي يظهر في الشريحة الذكية لمعاينة الرابط.

LoadIndicator

أماكن إقامة

الموقعالنوعالوصف
SPINNEREnumاستخدِم مؤشرًا للتقدّم.
NONEEnumلا تستخدِم مؤشرًا.

MaterialIcon

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setFill(fill)MaterialIconما إذا كان سيتم عرض الرمز ممتلئًا
setGrade(grade)MaterialIconيؤثران في سمك الرمز.
setName(name)MaterialIconتُستخدَم لضبط اسم الرمز.
setWeight(weight)MaterialIconكثافة خط الرمز

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
popCard()Navigationإخراج بطاقة من حزمة التنقّل
popToNamedCard(cardName)Navigationالانتقال إلى البطاقة المحدّدة حسب اسمها
popToRoot()Navigationإخراج حزمة البطاقات إلى البطاقة الجذر
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.
pushCard(card)Navigationتدفع البطاقة المحدّدة إلى أعلى الحزمة.
updateCard(card)Navigationيتم استبدال البطاقة الحالية في مكانها.

Notification

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setText(text)Notificationلضبط النص الذي سيتم عرضه في الإشعار

OnClose

أماكن إقامة

الموقعالنوعالوصف
NOTHINGEnumعدم اتّخاذ أي إجراء عند الإغلاق
RELOADEnumإعادة تحميل الإضافة عند إغلاق النافذة

OpenAs

أماكن إقامة

الموقعالنوعالوصف
FULL_SIZEEnumفتح علامة تبويب أو نافذة كاملة
OVERLAYEnumفتحها كعنصر تراكبي، مثل نافذة منبثقة

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setOnClose(onClose)OpenLinkلضبط سلوك إجراء عنوان URL عند إغلاق نافذة أو علامة تبويب عنوان URL
setOpenAs(openAs)OpenLinkتُستخدَم لضبط سلوك عنوان URL عند فتحه.
setUrl(url)OpenLinkتُستخدَم لضبط عنوان URL المطلوب فتحه.

OverflowMenu

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addMenuItem(menuItem)OverflowMenuتُضيف عنصرًا إلى القائمة.

OverflowMenuItem

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAuthorizationAction(action)OverflowMenuItemتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setComposeAction(action, composedEmailType)OverflowMenuItemتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setDisabled(disabled)OverflowMenuItemلضبط ما إذا كان عنصر القائمة غير مفعّل
setOnClickAction(action)OverflowMenuItemتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)OverflowMenuItemتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)OverflowMenuItemتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.
setStartIcon(icon)OverflowMenuItemلضبط الرمز الأول لعنصر القائمة
setText(text)OverflowMenuItemلضبط عنوان عنصر القائمة

PlatformDataSource

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setCommonDataSource(commonDataSource)PlatformDataSourceلضبط مصدر البيانات من Google Workspace
setHostAppDataSource(hostAppDataSource)PlatformDataSourceتُستخدَم لتعبئة المساحات في قائمة الاختيار المتعدّد.

ResponseType

أماكن إقامة

الموقعالنوعالوصف
TYPE_UNSPECIFIEDEnumالنوع التلقائي الذي يتم التعامل معه على أنّه NEW_MESSAGE
NEW_MESSAGEEnumانشر الردّ كرسالة جديدة في الموضوع.
UPDATE_MESSAGEEnumعدِّل رسالة تطبيق Chat.
UPDATE_USER_MESSAGE_CARDSEnumتعديل البطاقات في رسالة أحد المستخدمين
REQUEST_CONFIGEnumاطلب من المستخدم بشكل خاص إجراء مصادقة أو ضبط إضافيَين.
DIALOGEnumعرض مربّع حوار
UPDATE_WIDGETEnumطلب بحث خيارات الإكمال التلقائي للنص في التطبيقات المصغّرة

SelectionInput

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addItem(text, value, selected)SelectionInputتضيف عنصرًا جديدًا يمكن اختياره.
addMultiSelectItem(text, value, selected, startIconUri, bottomText)SelectionInputتُضيف عنصرًا جديدًا يمكن اختياره، وذلك للقوائم التي تتيح الاختيار من بين عناصر متعددة.
setExternalDataSource(action)SelectionInputتُستخدَم لضبط مصدر بيانات خارجي، مثل قاعدة بيانات ارتباطية.
setFieldName(fieldName)SelectionInputتُستخدَم لضبط المفتاح الذي يحدِّد مصدر إدخال الاختيار هذا في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setMultiSelectMaxSelectedItems(maxSelectedItems)SelectionInputتُستخدَم لضبط الحد الأقصى لعدد العناصر التي يمكن للمستخدم اختيارها.
setMultiSelectMinQueryLength(queryLength)SelectionInputلضبط عدد أحرف النص التي يُدخلها المستخدم قبل أن يطلب التطبيق إكمالها تلقائيًا ويُظهِر العناصر المقترَحة على البطاقة.
setOnChangeAction(action)SelectionInputتُستخدَم لضبط Action ليتم تنفيذه عند تغيير إدخال الاختيار.
setPlatformDataSource(platformDataSource)SelectionInputلضبط مصدر بيانات من Google Workspace
setTitle(title)SelectionInputلضبط العنوان الذي سيتم عرضه قبل حقل الإدخال.
setType(type)SelectionInputتُستخدَم لضبط نوع الإدخال هذا.

SelectionInputType

أماكن إقامة

الموقعالنوعالوصف
CHECK_BOXEnumنمط إدخال مربّع الاختيار
RADIO_BUTTONEnumنمط إدخال زر الاختيار
DROPDOWNEnumنمط إدخال اختيار القائمة المنسدلة
SWITCHEnumمجموعة من مفاتيح التبديل
MULTI_SELECTEnumقائمة اختيار متعدّد للبيانات الثابتة أو الديناميكية

Status

أماكن إقامة

الموقعالنوعالوصف
OKEnumتعيين HTTP: 200 OK
CANCELLEDEnumتعيين HTTP: 499 طلب إغلاق العميل
UNKNOWNEnumحدث خطأ غير معروف.
INVALID_ARGUMENTEnumحدّد العميل وسيطة غير صالحة.
DEADLINE_EXCEEDEDEnumتعيين HTTP: انتهت مهلة الوكيل 504
NOT_FOUNDEnumتعيين HTTP: 404 لم يتم العثور عليه
ALREADY_EXISTSEnumالكيان الذي حاول العميل إنشاؤه متوفّر مسبقًا.
PERMISSION_DENIEDEnumتعيين HTTP: 403 محظور
UNAUTHENTICATEDEnumتعيين HTTP: 401 غير مصرّح به
RESOURCE_EXHAUSTEDEnumتعيين HTTP: 429 Too Many Requests
FAILED_PRECONDITIONEnumتم رفض العملية لأنّ النظام ليس في الحالة المطلوبة لتنفيذ العملية.
ABORTEDEnumتم إلغاء العملية، وعادةً ما يكون ذلك بسبب مشكلة في التوافق، مثل تعذُّر فحص التسلسل أو إلغاء المعاملة.
OUT_OF_RANGEEnumتمّت محاولة إجراء العملية بعد النطاق المسموح به.
UNIMPLEMENTEDEnumتعيين HTTP: 501 Not Implemented
INTERNALEnumالأخطاء الداخلية
UNAVAILABLEEnumتعيين HTTP: 503 الخدمة غير متاحة
DATA_LOSSEnumثمة بيانات تالفة أو مفقودة ويتعذّر استرجاعها.

Suggestions

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addSuggestion(suggestion)Suggestionsأضِف اقتراحًا نصيًا.
addSuggestions(suggestions)Suggestionsأضِف قائمة باقتراحات النصوص.

SuggestionsResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

SuggestionsResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
build()SuggestionsResponseينشئ ردّ الاقتراحات الحالي ويتحقق منه.
setSuggestions(suggestions)SuggestionsResponseBuilderتُستخدَم لضبط الاقتراحات المستخدَمة في ميزة "الإكمال التلقائي" في الحقول النصية.

Switch

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setControlType(controlType)Switchلضبط نوع التحكّم في المفتاح
setFieldName(fieldName)Switchتُستخدَم لضبط المفتاح الذي يحدِّد هذا المفتاح في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setOnChangeAction(action)Switchتُستخدَم لضبط الإجراء الذي سيتم اتّخاذه عند تبديل المفتاح.
setSelected(selected)Switchلضبط ما إذا كان يجب بدء هذا المفتاح مُحدَّدًا أو غير محدَّد
setValue(value)Switchتُستخدَم لضبط القيمة التي يتم إرسالها كإدخال النموذج عند تفعيل هذا المفتاح.

SwitchControlType

أماكن إقامة

الموقعالنوعالوصف
SWITCHEnumعنصر تحكّم بتصميم زر التبديل لأداة التبديل
CHECK_BOXEnumعنصر تحكّم بتصميم مربّع الاختيار لتطبيق مصغّر للتبديل

TextButton

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setAltText(altText)TextButtonتُستخدَم لضبط النص البديل للزر من أجل تسهيل الاستخدام.
setAuthorizationAction(action)TextButtonتُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
setBackgroundColor(backgroundColor)TextButtonلضبط لون خلفية الزر TextButtonStyle.FILLED.
setComposeAction(action, composedEmailType)TextButtonتُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setDisabled(disabled)TextButtonلتحديد ما إذا كان الزر غير مفعّل
setIcon(icon)TextButtonلضبط رمز Icon محدّد مسبقًا لعرضه على الزر
setIconUrl(url)TextButtonلضبط عنوان URL لصورة لاستخدامها كرمز لهذا الزر.
setMaterialIcon(icon)TextButtonتُستخدَم لضبط رمز التصميم المتعدّد الأبعاد.
setOnClickAction(action)TextButtonتُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)TextButtonتُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)TextButtonتُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.
setOverflowMenu(menu)TextButtonلضبط قائمة منبثقة يتم فتحها عند النقر على العنصر.
setText(text)TextButtonلضبط النص الذي يظهر على الزر
setTextButtonStyle(textButtonStyle)TextButtonلضبط نمط الزر

TextButtonStyle

أماكن إقامة

الموقعالنوعالوصف
OUTLINEDEnumزر نص عادي مع خلفية شفافة
TEXTEnumيُرجى عدم استخدامها.
FILLEDEnumزر نصي بخلفية ملونة
FILLED_TONALEnumزر نص عادي مع خيار بديل بين الأزرار الملونة والمخطّطة
BORDERLESSEnumزر نص عادي بدون حدود

TextInput

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setFieldName(fieldName)TextInputتُستخدَم لضبط المفتاح الذي يحدِّد إدخال النص هذا في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setHint(hint)TextInputلضبط تلميح لإدخال النص
setMultiline(multiline)TextInputلضبط ما إذا كان نص الإدخال يظهر على سطر واحد أو عدة أسطر.
setOnChangeAction(action)TextInputتُستخدَم لضبط إجراء يتم تنفيذه عند تغيير إدخال النص.
setSuggestions(suggestions)TextInputلضبط الاقتراحات الخاصة بالملء التلقائي في حقل النص
setSuggestionsAction(suggestionsAction)TextInputتُستخدَم لضبط إجراء طلب إعادة الاتصال من أجل جلب اقتراحات استنادًا إلى إدخال المستخدم لإكمالها تلقائيًا.
setTitle(title)TextInputلضبط العنوان الذي سيتم عرضه أعلى حقل الإدخال.
setValidation(validation)TextInputلضبط قاعدة التحقّق من الصحة لهذه الأداة المصغّرة.
setValue(value)TextInputلضبط القيمة المعبأة مسبقًا في حقل الإدخال

TextParagraph

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setMaxLines(maxLines)TextParagraphلتحديد الحد الأقصى لعدد أسطر النص المعروضة في التطبيق المصغّر
setText(text)TextParagraphلضبط نص الفقرة

TimePicker

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setFieldName(fieldName)TimePickerتُستخدَم لضبط اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setHours(hours)TimePickerتُستخدَم لضبط قيمة ساعات العمل المعبأة مسبقًا في حقل الإدخال.
setMinutes(minutes)TimePickerتُستخدَم لضبط قيمة الدقائق المعبأة مسبقًا في حقل الإدخال.
setOnChangeAction(action)TimePickerتُستخدَم لضبط Action ينفّذها النص البرمجي كلما تغيّرت إدخالات أداة الاختيار.
setTitle(title)TimePickerلضبط العنوان المعروض أعلى حقل الإدخال.

UniversalActionResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

UniversalActionResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
build()UniversalActionResponseتُنشئ هذه الوظيفة ردّ الإجراء الشامل الحالي وتُجري فحصًا له.
displayAddOnCards(cardObjects)UniversalActionResponseBuilderتعرِض هذه السمة الإضافة مع البطاقات المحدّدة.
setOpenLink(openLink)UniversalActionResponseBuilderلضبط عنوان URL الذي سيتم فتحه عند اختيار الإجراء الشامل.

UpdateDraftActionResponse

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
printJson()Stringتُطبع تمثيل JSON لهذا الكائن.

UpdateDraftActionResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
build()UpdateDraftActionResponseينشئ ردّ إجراء مسودة التعديل الحالي ويتحقق منه.
setUpdateDraftBccRecipientsAction(updateDraftBccRecipientsAction)UpdateDraftActionResponseBuilderتُستخدَم لضبط إجراء يعدّل مستلمي نسخة مخفية الوجهة من الرسالة الإلكترونية لمسوّدة.
setUpdateDraftBodyAction(updateDraftBodyAction)UpdateDraftActionResponseBuilderاضبط إجراءً يعدّل نص الرسالة الإلكترونية لمسودة.
setUpdateDraftCcRecipientsAction(updateDraftCcRecipientsAction)UpdateDraftActionResponseBuilderتُستخدَم لضبط إجراء يعدّل مستلمي نسخة "نسخة إلى" المسودة.
setUpdateDraftSubjectAction(updateDraftSubjectAction)UpdateDraftActionResponseBuilderتُستخدَم لضبط إجراء يعدّل سطر موضوع مسودة.
setUpdateDraftToRecipientsAction(updateDraftToRecipientsAction)UpdateDraftActionResponseBuilderتُستخدَم لضبط إجراء يعدّل مستلمي حقل "إلى" في مسودة.

UpdateDraftBccRecipientsAction

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addUpdateBccRecipients(bccRecipientEmails)UpdateDraftBccRecipientsActionتعديل مستلمي نسخة مخفية الوجهة لرسالة إلكترونية مسودة

UpdateDraftBodyAction

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addUpdateContent(content, contentType)UpdateDraftBodyActionتضيف هذه السمة المحتوى المحدّد إلى نص المسودة.
setUpdateType(updateType)UpdateDraftBodyActionتُستخدَم لضبط UpdateDraftBodyType للإجراء "تعديل" هذا في نص المسودة.

UpdateDraftBodyType

أماكن إقامة

الموقعالنوعالوصف
IN_PLACE_INSERTEnumتلقائي:
INSERT_AT_STARTEnumتُدرج إجراءات التعديل المحتوى في بداية نص الرسالة.
INSERT_AT_ENDEnumتُدرج إجراءات التعديل محتوى في نهاية نص الرسالة.

UpdateDraftCcRecipientsAction

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addUpdateCcRecipients(ccRecipientEmails)UpdateDraftCcRecipientsActionتعديل مستلمي نسخة من مسودة رسالة إلكترونية

UpdateDraftSubjectAction

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addUpdateSubject(subject)UpdateDraftSubjectActionتعديل سطر موضوع مسودة رسالة إلكترونية

UpdateDraftToRecipientsAction

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addUpdateToRecipients(toRecipientEmails)UpdateDraftToRecipientsActionتعديل مستلمي "إلى" مسودة رسالة إلكترونية

UpdatedWidget

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
addItem(text, value, selected, startIconUri, bottomText)UpdatedWidgetتضيف عنصرًا جديدًا يمكن اختياره.

Validation

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
setCharacterLimit(characterLimit)Validationلضبط الحد الأقصى لعدد الأحرف في التطبيق المصغّر
setInputType(inputType)Validationلضبط نوع الإدخال في التطبيق المصغّر

VerticalAlignment

أماكن إقامة

الموقعالنوعالوصف
CENTEREnumيتم وضع المحتوى عموديًا في منتصف الحاوية.
TOPEnumيتم وضع المحتوى عموديًا في أعلى الحاوية.
BOTTOMEnumيتم وضع المحتوى عموديًا في أسفل الحاوية.

Widget

WrapStyle

أماكن إقامة

الموقعالنوعالوصف
NOWRAPEnumلا يتم استخدام ميزة "التفاف النص".
WRAPEnumلالتفاف محتوى أي تطبيقات مصغّرة في عمود