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توفّر خدمة Card إمكانية إنشاء بطاقات عامة يمكن استخدامها في مختلف منتجات Google التي تتيح إمكانية التوسيع، مثل إضافات Google Workspace.
CardWithIdأداة إنشاء لعناصر CardWithId
Carouselتعمل لوحة العرض الدوّارة، المعروفة أيضًا باسم شريط التمرير، على تدوير وعرض قائمة من التطبيقات المصغّرة بتنسيق عرض الشرائح، مع أزرار للتنقّل إلى التطبيق المصغّر السابق أو التالي.
CarouselCardبطاقة يمكن عرضها كعنصر في لوحة عرض دوّارة
ChatActionResponseفئة تمثّل المَعلمات التي يمكن أن يستخدمها تطبيق Chat لتحديد طريقة نشر الرد.
ChatClientDataSourceبالنسبة إلى أداة SelectionInput تستخدم قائمة اختيار متعدّد، يجب أن يكون مصدر البيانات من Google Chat.
ChatResponseكائن الرد لرسالة بطاقة في Google Chat.
ChatResponseBuilderأداة إنشاء لعناصر ChatResponse
ChatSpaceDataSourceمصدر بيانات يملأ مساحات Google Chat كعناصر اختيار لقائمة اختيار متعدّد.
ChipChip يحتوي على رمز وتصنيف نصي
ChipListتحتوي على مجموعة من عناصر Chip يتم عرضها في صف واحد، مع الانتقال إلى السطر التالي عند الحاجة إلى التمرير الأفقي.
ChipListLayoutتعداد يحدّد التنسيق الخاص بـ ChipList.
CollapseControlعنصر تحكّم قابل للتخصيص لتصغير المحتوى وتوسيعه
Columnعمود
Columnsتعرض الأداة Columns ما يصل إلى عمودَين في بطاقة أو مربّع حوار.
CommonDataSourceمصدر بيانات تتم مشاركته بين جميع تطبيقات Google Workspace
CommonWidgetActionتحدّد هذه السمة الإجراءات التي لا تتضمّن تقييمات، مثل تعديل إذن الوصول إلى الأداة.
ComposeActionResponseكائن الردّ الذي يمكن إرجاعه من طريقة ردّ لإنشاء إجراء في إضافة Gmail.
ComposeActionResponseBuilderأداة إنشاء لعناصر ComposeActionResponse
ComposedEmailTypeقيمة تعداد تحدّد ما إذا كانت الرسالة الإلكترونية التي تم إنشاؤها هي مسودة مستقلة أو مسودة رد.
Conditionشرط يُستخدَم لتنفيذ إجراء حدث كجزء من التحقّق من صحة تعبير CEL
ContentTypeقيمة تعداد تحدّد نوع المحتوى الذي تم إنشاؤه بواسطة UpdateDraftActionResponse.
DataSourceConfigكائن إعداد يساعد في ضبط مصادر البيانات لأداة.
DatePickerحقل إدخال يسمح بإدخال تاريخ.
DateTimePickerحقل إدخال يسمح للمستخدمين بإدخال التاريخ والوقت.
DecoratedTextأداة تعرض نصًا مع زخارف اختيارية.
Dialogلمزيد من التفاصيل، راجِع مقالة فتح مربّعات حوار تفاعلية في مستندات Google Chat.
DialogActionأداة إنشاء لعناصر DialogAction
DisplayStyleتعداد يحدّد نمط عرض البطاقة.
Dividerخط فاصل أفقي
DriveDataSourceSpecتحتوي على مجموعة من عناصر DriveItemType المعروضة في صف.
DriveItemTypeتحدّد قيمة التعداد نوع الملف لعنصر في Drive.
DriveItemsSelectedActionResponseيمثّل هذا النوع ردًا يُجري تغييرات على Drive أثناء تحديد عناصر Drive وكرد فعل على إجراء تم اتخاذه في واجهة المستخدم، مثل النقر على زر.
DriveItemsSelectedActionResponseBuilderأداة إنشاء لعناصر DriveItemsSelectedActionResponse
EditorFileScopeActionResponseتُجري تغييرات على "أداة التحرير"، مثل "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"، استجابةً لإجراء تم اتخاذه في واجهة المستخدم.
EditorFileScopeActionResponseBuilderأداة إنشاء لعناصر EditorFileScopeActionResponse
EventActionتمثّل هذه السمة EventAction يتم تنفيذه عند استيفاء شرط التحقّق من صحة تعبير CEL.
ExpressionDataبيانات التعبير المستخدَمة لتقييم تعبير.
ExpressionDataActionإجراءات التحقّق من صحة تعبير CEL
ExpressionDataActionTypeتعداد يمثّل نوع إجراء البيانات الخاص بالتعبير.
ExpressionDataConditionتمثّل هذه السمة نتيجة التحقّق من صحة تعبير CEL.
ExpressionDataConditionTypeتمثّل ما إذا تم تقييم تعبير CEL بنجاح.
FixedFooterالتذييل الثابت الذي يظهر في أسفل Card
Gridشبكة منظَّمة لعرض مجموعة من عناصر الشبكة
GridItemالعناصر التي يتفاعل معها المستخدمون ضِمن أداة شبكة
GridItemLayoutتعداد يحدّد نمط الصورة والنص الخاصَّين بـ GridItem.
HorizontalAlignmentتعداد يحدّد المحاذاة الأفقية لعنصر واجهة مستخدم.
HorizontalSizeStyleتعداد يحدّد كيفية ملء التطبيقات المصغّرة لمساحة عمود.
HostAppDataSourceبالنسبة إلى أداة SelectionInput تستخدم قائمة اختيار متعدّد، يجب توفير مصدر بيانات من أحد تطبيقات Google Workspace.
Iconرموز محددة مسبقًا يمكن استخدامها في عناصر مختلفة لواجهة المستخدم، مثل أدوات ImageButton أو DecoratedText.
IconImageأيقونة محدّدة مسبقًا أو أيقونة Material Design أو أيقونة من عنوان URL مع نمط اقتصاص قابل للتخصيص
Imageأداة تعرض صورة واحدة.
ImageButtonImageButton يعرض صورة
ImageButtonStyleتعداد يحدّد نمط ImageButton.
ImageComponentمكوّن صورة يمكن إضافته إلى عناصر الشبكة
ImageCropStyleفئة تمثّل نمط قص يمكن تطبيقه على مكوّنات الصور.
ImageCropTypeتعداد يمثّل أنماط الاقتصاص المطبَّقة على مكوّنات الصور.
ImageStyleتعداد يحدّد نمط اقتصاص الصورة.
InputTypeتعداد يحدّد نوع إدخال الأداة.
Interactionنوع تعداد يحدّد الإجراء الذي يجب اتّخاذه استجابةً لتفاعل مع مستخدم، مثل نقر المستخدم على زر في رسالة بطاقة.
KeyValueتم إيقاف هذه الفئة نهائيًا.
LinkPreviewإجراء البطاقة الذي يعرض بطاقة معاينة الرابط وشريحة ذكية في التطبيق المضيف
LoadIndicatorنوع تعداد يحدّد نوع مؤشر التحميل أو التقدّم الذي سيتم عرضه أثناء معالجة Action.
MaterialIconعنصر يتوافق مع جميع رموز Google Font
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أداة حقل إدخال تقبل إدخال النص.
TextInputModeتعداد يحدّد نوع الإدخال المسموح به لحقل إدخال النص.
TextParagraphأداة تعرض نصًا وتتيح تنسيق HTML الأساسي
TimePickerحقل إدخال يتيح للمستخدمين إدخال وقت.
Triggerمشغّل ينفّذ إجراءات أحداث أداة التحقّق من صحة تعبير CEL وفقًا لرقم تعريف قاعدة الإجراء.
UniversalActionResponseكائن الردّ الذي يمكن أن يتم عرضه من خلال طريقة تنشئ إجراءً عالميًا.
UniversalActionResponseBuilderأداة إنشاء لكائنات UniversalActionResponse
UpdateDraftActionResponseتمثّل هذه السمة إجراءً يعدّل مسودة الرسالة الإلكترونية التي يعدّلها المستخدم حاليًا.
UpdateDraftActionResponseBuilderأداة إنشاء لعناصر UpdateDraftActionResponse
UpdateDraftBccRecipientsActionتعدّل هذه الطريقة مستلمي "نسخة مخفية الوجهة" من مسودة رسالة إلكترونية.
UpdateDraftBodyActionتعدّل هذه الطريقة نص مسودة الرسالة الإلكترونية.
UpdateDraftBodyTypeقيمة محدّدة مسبقًا تحدّد نوع UpdateDraftBodyAction.
UpdateDraftCcRecipientsActionتعدّل هذه الطريقة مستلمي "نسخة إلى" من مسودة رسالة إلكترونية.
UpdateDraftSubjectActionتعدّل هذه الطريقة سطر الموضوع في مسودة رسالة إلكترونية.
UpdateDraftToRecipientsActionتعديل المستلمين في حقل "إلى" في مسودة رسالة إلكترونية
UpdateVisibilityActionتعدّل هذه السمة مستوى ظهور أداة البطاقة لعرضها أو إخفائها.
UpdatedWidgetردّ التطبيق المصغّر المعدَّل
Validationكائن يحدّد قاعدة التحقّق من صحة البيانات الخاصة بالأداة التي تم ربطه بها.
VariableButtonSizeتعداد يمثّل حجم زر أداة اختيار المتغيرات.
VerticalAlignmentتعداد يضبط المحاذاة العمودية للعناصر في عمود.
Visibilityتعداد يمثّل حالة ظهور الأدوات.
Widgetفئة أساسية لجميع التطبيقات المصغّرة التي يمكن إضافتها إلى Card.
WorkflowDataSourceبالنسبة إلى التطبيق المصغّر SelectionInput أو DateTimePicker أو TextInput، يكون مصدر البيانات مستخدَمًا في Google Workspace Studio.
WorkflowDataSourceTypeتعداد يمثّل نوع مصدر بيانات سير العمل.
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تضيف هذه السمة زرًا.
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

CalendarEventActionResponse

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
printJson()Stringتعرض هذه السمة تمثيل JSON لهذا العنصر.

CalendarEventActionResponseBuilder

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addAttachments(attachments)CalendarEventActionResponseBuilderتحدّد هذه السمة أنّ الردّ يجب أن يضيف المرفقات إلى حدث "تقويم Google" عند اتّخاذ إجراء واجهة المستخدم المرتبط.
addAttendees(emails)CalendarEventActionResponseBuilderتحدّد هذه السمة أنّه يجب أن تضيف الاستجابة الضيوف المحدّدين إلى حدث "تقويم Google" عند اتّخاذ إجراء واجهة المستخدم المرتبط.
build()CalendarEventActionResponseتنشئ هذه الطريقة الردّ الحالي على إجراء حدث التقويم وتتحقّق من صحته.
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 إلى هذه البطاقة.
addExpressionData(expressionData)CardBuilderتضيف هذه الطريقة بيانات تعبير إلى هذه البطاقة.
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تضبط هذه السمة عنوان القسم.
setId(id)CardSectionتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد القسم الذي سيتمّ تعديله.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionتضبط هذه السمة عدد التطبيقات المصغّرة التي تظل معروضة عند تصغير هذا القسم.

CardService

الخصائص

الموقعالنوعالوصف
BorderTypeBorderTypeتعداد BorderType
ChipListLayoutChipListLayoutتعداد ChipListLayout
CommonDataSourceCommonDataSourceتعداد CommonDataSource
ComposedEmailTypeComposedEmailTypeتعداد ComposedEmailType
ContentTypeContentTypeتعداد ContentType
DriveItemTypeDriveItemTypeتعداد DriveItemType
ExpressionDataActionTypeExpressionDataActionTypeتعداد ExpressionDataActionType
ExpressionDataConditionTypeExpressionDataConditionTypeتعداد ExpressionDataConditionType
GridItemLayoutGridItemLayoutتعداد GridItemLayout
HorizontalAlignmentHorizontalAlignmentتعداد HorizontalAlignment
IconIconتعداد Icon
ImageButtonStyleImageButtonStyleتعداد ImageButtonStyle
ImageCropTypeImageCropTypeتعداد ImageCropType
ImageStyleImageStyleتعداد ImageStyle
InputTypeInputTypeتعداد InputType
LoadIndicatorLoadIndicatorتعداد LoadIndicator
OnCloseOnCloseتعداد OnClose
OpenAsOpenAsتعداد OpenAs
SelectionInputTypeSelectionInputTypeتعداد SelectionInputType
TextButtonStyleTextButtonStyleتعداد TextButtonStyle
TextInputModeTextInputModeتعداد TextInputMode
UpdateDraftBodyTypeUpdateDraftBodyTypeتعداد UpdateDraftBodyType
VariableButtonSizeVariableButtonSizeتعداد VariableButtonSize
VisibilityVisibilityتعداد Visibility
WorkflowDataSourceTypeWorkflowDataSourceTypeتعداد WorkflowDataSourceType

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
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 جديدًا.
newCarousel()Carouselتنشئ هذه الدالة Carousel.
newCarouselCard()CarouselCardتنشئ هذه الدالة CarouselCard جديدًا.
newChatActionResponse()ChatActionResponseتنشئ هذه الدالة ChatActionResponse جديدًا.
newChatResponseBuilder()ChatResponseBuilderتنشئ هذه الدالة ChatResponseBuilder جديدًا.
newChip()Chipتنشئ هذه الدالة Chip جديدًا.
newChipList()ChipListتنشئ هذه الدالة ChipList جديدًا.
newCollapseControl()CollapseControlتنشئ هذه الدالة CollapseControl جديدًا.
newColumn()Columnتنشئ هذه الدالة Column جديدًا.
newColumns()Columnsتنشئ هذه السمة مجموعة جديدة من Columns.
newCommonWidgetAction()CommonWidgetActionتنشئ هذه الدالة CommonWidgetAction جديدًا.
newComposeActionResponseBuilder()ComposeActionResponseBuilderتنشئ هذه الدالة ComposeActionResponseBuilder جديدًا.
newCondition()Conditionتنشئ هذه السمة Condition جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
newDataSourceConfig()DataSourceConfigتُنشئ هذه الطريقة DataSourceConfig فارغًا جديدًا.
newDatePicker()DatePickerتنشئ هذه الدالة DatePicker جديدًا.
newDateTimePicker()DateTimePickerتنشئ هذه الدالة DateTimePicker جديدًا.
newDecoratedText()DecoratedTextتنشئ هذه الدالة DecoratedText جديدًا.
newDialog()Dialogتنشئ هذه الدالة Dialog جديدًا.
newDialogAction()DialogActionتنشئ هذه الدالة DialogAction جديدًا.
newDivider()Dividerتنشئ هذه الدالة Divider جديدًا.
newDriveDataSourceSpec()DriveDataSourceSpecتنشئ هذه الدالة DriveDataSourceSpec جديدًا.
newDriveItemsSelectedActionResponseBuilder()DriveItemsSelectedActionResponseBuilderتنشئ هذه الدالة DriveItemsSelectedActionResponseBuilder جديدًا.
newEditorFileScopeActionResponseBuilder()EditorFileScopeActionResponseBuilderتنشئ هذه الدالة EditorFileScopeActionResponseBuilder جديدًا.
newEventAction()EventActionتنشئ هذه السمة EventAction جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
newExpressionData()ExpressionDataتنشئ هذه السمة ExpressionData جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
newExpressionDataAction()ExpressionDataActionتنشئ هذه السمة ExpressionDataAction جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
newExpressionDataCondition()ExpressionDataConditionتنشئ هذه السمة ExpressionDataCondition جديدة تُستخدَم للتحقّق من صحة البيانات من جهة العميل.
newFixedFooter()FixedFooterتنشئ هذه الدالة FixedFooter جديدًا.
newGrid()Gridتنشئ هذه الدالة Grid جديدًا.
newGridItem()GridItemتنشئ هذه الدالة GridItem جديدًا.
newHostAppDataSource()HostAppDataSourceتنشئ هذه الدالة HostAppDataSource جديدًا.
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 جديدًا.
newPlatformDataSource()PlatformDataSourceتنشئ هذه الدالة PlatformDataSource جديدًا.
newSelectionInput()SelectionInputتنشئ هذه الدالة SelectionInput جديدًا.
newSuggestions()Suggestionsتنشئ هذه الدالة Suggestions جديدًا.
newSuggestionsResponseBuilder()SuggestionsResponseBuilderتنشئ هذه الدالة SuggestionsResponseBuilder جديدًا.
newSwitch()Switchتنشئ هذه الدالة Switch جديدًا.
newTextButton()TextButtonتنشئ هذه الدالة TextButton جديدًا.
newTextInput()TextInputتنشئ هذه الدالة TextInput جديدًا.
newTextParagraph()TextParagraphتنشئ هذه الدالة TextParagraph جديدًا.
newTimePicker()TimePickerتنشئ هذه الدالة TimePicker جديدًا.
newTrigger()Triggerتنشئ هذه الدالة عنصر Trigger جديدًا وتُرجعه، ويُستخدم هذا العنصر للتحقّق من صحة البيانات من جهة العميل.
newUniversalActionResponseBuilder()UniversalActionResponseBuilderتنشئ هذه الدالة UniversalActionResponseBuilder جديدًا.
newUpdateDraftActionResponseBuilder()UpdateDraftActionResponseBuilderتنشئ هذه الدالة UpdateDraftActionResponseBuilder جديدًا.
newUpdateDraftBccRecipientsAction()UpdateDraftBccRecipientsActionتُنشئ هذه الطريقة UpdateDraftBccRecipientsAction جديدًا.
newUpdateDraftBodyAction()UpdateDraftBodyActionتنشئ هذه الدالة UpdateDraftBodyAction جديدًا.
newUpdateDraftCcRecipientsAction()UpdateDraftCcRecipientsActionتنشئ هذه الدالة UpdateDraftCcRecipientsAction جديدًا.
newUpdateDraftSubjectAction()UpdateDraftSubjectActionتنشئ هذه الدالة UpdateDraftSubjectAction جديدًا.
newUpdateDraftToRecipientsAction()UpdateDraftToRecipientsActionتنشئ هذه الدالة UpdateDraftToRecipientsAction جديدًا.
newUpdateVisibilityAction()UpdateVisibilityActionتنشئ هذه الدالة UpdateVisibilityAction جديدًا.
newValidation()Validationتنشئ هذه الدالة Validation جديدًا.
newWorkflowDataSource()WorkflowDataSourceتنشئ هذه الدالة WorkflowDataSource جديدًا.

CardWithId

الطُرق

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

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addCarouselCard(card)Carouselتضيف هذه السمة بطاقة منصّة عرض بعناصر متغيّرة.
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

CarouselCard

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addFooterWidget(widget)CarouselCardتضيف هذه السمة عنصر واجهة المستخدم المحدّد إلى تذييل بطاقة العرض الدوّار هذه.
addWidget(widget)CarouselCardتضيف هذه الطريقة التطبيق المصغّر المحدّد إلى بطاقة العرض الدوّار هذه.

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تضيف هذه السمة شريحة.
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setLayout(layout)ChipListتضبط هذه السمة تنسيق قائمة الشرائح.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

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 إلى التطبيق المصغّر "الأعمدة".
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.
setWrapStyle(wrapStyle)Columnsيضبط هذا السمة نمط التفاف الأعمدة، ويتحكّم في كيفية تغيير حجم العمود استنادًا إلى عرض الشاشة.

CommonDataSource

الخصائص

الموقعالنوعالوصف
UNKNOWNEnumالقيمة التلقائية
USEREnumمستخدمو Google Workspace
DRIVEEnumاستخدِم Google Drive كمصدر بيانات.

CommonWidgetAction

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
setUpdateVisibilityAction(updateVisibilityAction)CommonWidgetActionتضبط هذه السمة إجراء مستوى رؤية التحديث للتطبيقات المصغّرة.

ComposeActionResponse

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
printJson()Stringتعرض هذه السمة تمثيل JSON لهذا العنصر.

ComposeActionResponseBuilder

الطُرق

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

ComposedEmailType

الخصائص

الموقعالنوعالوصف
REPLY_AS_DRAFTEnumمسودّة تمثل ردًا على رسالة أخرى
STANDALONE_DRAFTEnumمسودة عبارة عن رسالة مستقلة

Condition

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
setActionRuleId(actionRuleId)Conditionالمعرّف الفريد لقاعدة الإجراء المطلوب تنفيذها استجابةً للشرط.
setExpressionDataCondition(expressionDataCondition)Conditionتضبط هذه السمة شرط التحقّق من صحة تعبير CEL المستخدَم لتحديد ما إذا كان يجب تنفيذ إجراء الحدث.

ContentType

الخصائص

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

DataSourceConfig

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
setMaxCharactersToDisable(maxCharactersToDisable)DataSourceConfigيضبط الحد الأقصى لعدد الأحرف التي يمكن للمستخدم إدخالها قبل إيقاف موفّر البيانات هذا.
setMaxResults(maxResults)DataSourceConfigتضبط هذه السمة الحد الأقصى لعدد النتائج التي سيتم عرضها.
setMinCharactersToTrigger(minCharactersToTrigger)DataSourceConfigتضبط هذه السمة الحد الأدنى لعدد الأحرف التي يجب أن يدخلها المستخدم قبل أن يتم تفعيل موفّر البيانات هذا لعرض النتائج.
setPlatformDataSource(platformDataSource)DataSourceConfigتضبط هذه السمة مصدر البيانات على مصدر بيانات تابع لمنصة.
setRemoteDataSource(action)DataSourceConfigتضبط هذه السمة مصدر البيانات على مقدّم بيانات بعيد.

DatePicker

الطُرق

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

DateTimePicker

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setFieldName(fieldName)DateTimePickerتضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setHostAppDataSource(hostAppDataSource)DateTimePickerفي مسار Google Workspace، تتيح متغيرات الإدخال قبول مخرجات التاريخ والوقت من خطوات أخرى في المسار.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setOnChangeAction(action)DateTimePickerيضبط هذا الخيار Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerتضبط هذه السمة عدد الدقائق التي يجب أن يتم فيها تعديل المنطقة الزمنية من التوقيت العالمي المتفق عليه.
setTitle(title)DateTimePickerتضبط هذه السمة العنوان المعروض أعلى حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerتضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerتضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

DecoratedText

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setAuthorizationAction(action)DecoratedTextيضبط هذا الإعداد إجراء تفويض يفتح عنوان URL لمسار التفويض عند النقر على العنصر.
setBottomLabel(text)DecoratedTextتضبط هذه السمة نص التصنيف الذي سيتم استخدامه كمفتاح ويتم عرضه أسفل المحتوى النصي.
setButton(button)DecoratedTextتضبط هذه السمة Button الذي يظهر على يسار النص.
setComposeAction(action, composedEmailType)DecoratedTextتضبط هذه السمة إجراءً ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setEndIcon(endIcon)DecoratedTextتضبط هذه السمة IconImage الاختيارية التي تظهر على يسار المحتوى.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
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تضبط هذه السمة نص التصنيف الذي سيتم استخدامه كمفتاح ويتم عرضه فوق المحتوى النصي.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.
setWrapText(wrapText)DecoratedTextتضبط هذه السمة ما إذا كان يجب عرض نص القيمة في سطر واحد أو عدة أسطر.

Dialog

الطُرق

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

DialogAction

الطُرق

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

DisplayStyle

الخصائص

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

Divider

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

DriveDataSourceSpec

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addItemType(driveItemType)DriveDataSourceSpecتضيف هذه الطريقة driveItemType إلى قائمة أنواع العناصر المسموح بها.

DriveItemType

الخصائص

الموقعالنوعالوصف
DRIVE_ITEM_TYPE_UNSPECIFIEDEnumالقيمة التلقائية
DOCUMENTSEnumتمثّل هذه السمة مستندًا في "مستندات Google".
SPREADSHEETSEnumتمثّل هذه السمة مستند "جداول بيانات Google".
PRESENTATIONSEnumيمثّل هذا النوع مستند "العروض التقديمية من Google".
PDFSEnumيمثّل مستند PDF.
FORMSEnumيمثّل مستند "نماذج Google".
FOLDERSEnumيمثّل هذا النوع مجلدًا في Google Drive.

DriveItemsSelectedActionResponse

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
printJson()Stringتعرض هذه السمة تمثيل JSON لهذا العنصر.

DriveItemsSelectedActionResponseBuilder

الطُرق

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

EditorFileScopeActionResponse

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
printJson()Stringتعرض هذه السمة تمثيل JSON لهذا العنصر.

EditorFileScopeActionResponseBuilder

الطُرق

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

EventAction

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addPostEventTrigger(trigger)EventActionتضيف هذه السمة شرط التحقّق من صحة تعبير CEL ليتم تقييمه بعد تنفيذ إجراء الحدث.
setActionRuleId(actionRuleId)EventActionتضبط هذه السمة معرّفًا فريدًا لإجراء الحدث.
setCommonWidgetAction(commonWidgetAction)EventActionضبط إجراء التطبيق المصغّر الشائع للتطبيقات المصغّرة
setExpressionDataAction(expressionDataAction)EventActionتضبط هذه السمة إجراء البيانات التحقّق من صحة تعبير CEL للعناصر.

ExpressionData

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addCondition(condition)ExpressionDataتضيف هذه الدالة شرطًا إلى بيانات التعبير الحالي.
addEventAction(eventAction)ExpressionDataتضيف هذه الدالة إجراء حدث إلى بيانات التعبير الحالية.
setExpression(expression)ExpressionDataتضبط قيمة بيانات التعبير.
setId(id)ExpressionDataتحدّد هذه السمة رقم تعريف بيانات التعبير.

ExpressionDataAction

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
setActionType(type)ExpressionDataActionتضبط هذه السمة نوع إجراء بيانات التعبير.

ExpressionDataActionType

الخصائص

الموقعالنوعالوصف
ACTION_TYPE_UNSPECIFIEDEnumنوع الإجراء غير المحدّد.
START_EXPRESSION_EVALUATIONEnumالإجراء لبدء التحقّق من صحة تعبير CEL

ExpressionDataCondition

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
setConditionType(type)ExpressionDataConditionتضبط هذه السمة نوع الشرط لعملية التحقّق من صحة تعبير CEL للإشارة إلى ما إذا تم تقييم التعبير بنجاح.

ExpressionDataConditionType

الخصائص

الموقعالنوعالوصف
CONDITION_TYPE_UNSPECIFIEDEnumنوع الشرط غير المحدّد
EXPRESSION_EVALUATION_SUCCESSEnumتم تقييم تعبير CEL بنجاح.
EXPRESSION_EVALUATION_FAILUREEnumتم تقييم تعبير CEL على أنّه نتيجة غير ناجحة.

FixedFooter

الطُرق

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

Grid

الطُرق

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

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.
setWorkflowDataSource(workflowDataSource)HostAppDataSourceتضبط هذه السمة مصدر البيانات من Google Workspace Flows.

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

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setAltText(altText)Imageتضبط هذه السمة النص البديل للصورة لتسهيل استخدامها.
setAuthorizationAction(action)Imageيضبط هذا الإعداد إجراء تفويض يفتح عنوان URL لمسار التفويض عند النقر على العنصر.
setComposeAction(action, composedEmailType)Imageتضبط هذه السمة إجراءً ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setImageUrl(url)Imageتضبط هذه السمة الصورة المطلوب استخدامها من خلال توفير عنوان URL أو سلسلة بيانات.
setOnClickAction(action)Imageتضبط هذه السمة إجراءً يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)Imageتضبط هذه السمة إجراءً يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)Imageتضبط هذه السمة عنوان URL ليتم فتحه عند النقر على العنصر.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

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

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setAuthorizationAction(action)KeyValueيضبط هذا الإعداد إجراء تفويض يفتح عنوان URL لمسار التفويض عند النقر على العنصر.
setComposeAction(action, composedEmailType)KeyValueتضبط هذه السمة إجراءً ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setOnClickAction(action)KeyValueتضبط هذه السمة إجراءً يتم تنفيذه عند النقر على العنصر.
setOnClickOpenLinkAction(action)KeyValueتضبط هذه السمة إجراءً يفتح عنوان URL في علامة تبويب عند النقر على العنصر.
setOpenLink(openLink)KeyValueتضبط هذه السمة عنوان URL ليتم فتحه عند النقر على العنصر.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

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.
setDriveDataSourceSpec(driveDataSourceSpec)PlatformDataSourceتضبط هذه السمة مواصفات مصدر بيانات Drive من 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

الطُرق

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

SelectionInputType

الخصائص

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

Status

الخصائص

الموقعالنوعالوصف
OKEnumربط HTTP: 200 OK
CANCELLEDEnumربط HTTP: 499 Client Closed Request
UNKNOWNEnumحدث خطأ غير معروف.
INVALID_ARGUMENTEnumحدّد العميل وسيطة غير صالحة.
DEADLINE_EXCEEDEDEnumربط HTTP: انتهت مهلة البوابة 504
NOT_FOUNDEnumتعيين HTTP: لم يتم العثور على الصفحة (404)
ALREADY_EXISTSEnumالكيان الذي حاول العميل إنشاءه متوفّر مسبقًا.
PERMISSION_DENIEDEnumتعيين HTTP: 403 Forbidden
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زر نص عادي بخلفية شفافة
TEXTEnumDO NOT USE.
FILLEDEnumزر نصي بخلفية ملونة
FILLED_TONALEnumزر نص عادي يمثّل حلاً وسطًا بين الأزرار المعبّأة والمحدّدة الجوانب
BORDERLESSEnumزر نص عادي بدون حدود

TextInput

الطُرق

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

TextInputMode

الخصائص

الموقعالنوعالوصف
PLAIN_TEXTEnumالسماح بإدخال نص عادي فقط
RICH_TEXTEnumإتاحة إدخال نص عادي ومتغيّرات في حقل إدخال نص

TextParagraph

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setMaxLines(maxLines)TextParagraphتضبط هذه السمة الحد الأقصى لعدد أسطر النص المعروضة في الأداة.
setText(text)TextParagraphتضبط هذه السمة نص الفقرة.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

TimePicker

الطُرق

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

Trigger

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
setActionRuleId(actionRuleId)Triggerتضبط هذه السمة معرّف قاعدة الإجراء للمشغّل.

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تعديل المستلمين في حقل "إلى" في مسودة رسالة إلكترونية

UpdateVisibilityAction

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
setVisibility(visibility)UpdateVisibilityActionتضبط هذه السمة مستوى ظهور التطبيقات المصغّرة على "مرئي" أو "مخفي".

UpdatedWidget

الطُرق

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

Validation

الطُرق

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

VariableButtonSize

الخصائص

الموقعالنوعالوصف
UNSPECIFIEDEnumيختار COMPACT تلقائيًا للوحة الجانبية، ويختار FULL_SIZE في الحالات الأخرى.
COMPACTEnumبالنسبة إلى الأزرار التي تحمل التصنيف `+`
FULL_SIZEEnumبالنسبة إلى الأزرار التي تحمل التصنيف `+ variable`

VerticalAlignment

الخصائص

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

Visibility

الخصائص

الموقعالنوعالوصف
VISIBLEEnumعنصر واجهة المستخدم مرئي.
HIDDENEnumعنصر واجهة المستخدم غير مرئي.
VISIBILITY_UNSPECIFIEDEnumلم يتم تحديد عنصر واجهة المستخدم.

Widget

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

WorkflowDataSource

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
setIncludeVariables(includeVariables)WorkflowDataSourceتحديد ما إذا كان سيتم تضمين متغيّرات من الخطوة السابقة في مصدر البيانات
setType(type)WorkflowDataSourceتُحدّد هذه السمة نوع مصدر بيانات سير العمل.
setVariableButtonLabel(variableButtonLabel)WorkflowDataSourceتضبط هذه السمة تصنيف زر اختيار المتغيّر الذي يظهر بعد علامة الجمع (+) في حجم الزر FULL_SIZE.
setVariableButtonSize(variableButtonSize)WorkflowDataSourceتضبط هذه السمة حجم زر اختيار المتغيّر، ويستخدم Workflow تلقائيًا COMPACT في اللوحة الجانبية وFULL_SIZE في الحالات الأخرى إذا تم اختيار UNSPECIFIED.

WorkflowDataSourceType

الخصائص

الموقعالنوعالوصف
UNKNOWNEnumالقيمة التلقائية
USEREnumمصدر البيانات هو بيانات المستخدم.
SPACEEnumمصدر البيانات هو مساحة Google Chat.
USER_WITH_FREE_FORMEnumمصدر البيانات هو بيانات المستخدم، ويمكن للمستخدمين اختيار عرض الأعضاء الحاليين واختيارهم من مؤسسة Google Workspace أو إدخال عنوان بريد إلكتروني أو نطاق صالح يدويًا.

WrapStyle

الخصائص

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