Package apps.extensions.markup

الفهرس

CalendarClientActionMarkup

الحقول
editAttendeesActionMarkup

EditAttendeesActionMarkup

إجراء يضيف مشاركين إلى حدث في "تقويم Google"

editConferenceDataActionMarkup

EditConferenceDataActionMarkup

إجراء يضيف بيانات الاجتماع إلى حدث في "تقويم Google". لا يمكن إنشاء إضافات مكالمات الفيديو التابعة لجهات خارجية إلا في برمجة تطبيقات Google.

addAttachmentsActionMarkup

AddAttachmentsActionMarkup

إجراء يضيف مرفقات إلى حدث في "تقويم Google"

createConferenceDataActionMarkup

CreateConferenceDataActionMarkup

إجراء يعرض بيانات الاجتماع عند إنشاء حدث في "تقويم Google"

createConferenceSettingUrlActionMarkup

CreateConferenceSettingUrlActionMarkup

إجراء يؤدي إلى إنشاء عنوان URL لإعدادات إنشاء اجتماع

calendarSubscriptionActionMarkup

CalendarSubscriptionActionMarkup

إجراء يدير اشتراكًا في تقويم تتيح إنشاء الاشتراكات في إضافات نقاط نهاية HTTP فقط. لا ينطبق ذلك على إضافات "برمجة تطبيقات Google".

AddAttachmentsActionMarkup

الحقول
addonAttachments[]

AddonAttachment

AddonAttachment

الحقول
resourceUrl

string

title

string

عنوان المرفق

mimeType

string

نوع MIME للمحتوى في resourceUrl

iconUrl

string

رابط يؤدي إلى رمز المرجع

CalendarSubscriptionActionMarkup

إجراء يدير اشتراكًا في تقويم للمستخدم الحالي

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

تتيح إنشاء الاشتراكات في إضافات نقاط نهاية HTTP فقط. لا ينطبق ذلك على إضافات "برمجة تطبيقات Google".

الحقول
operation

Operation

العملية المطلوب تنفيذها لا يتوفّر حاليًا سوى CREATE. إنّ إنشاء اشتراك هو عملية متكررة.

calendarId

string

معرّف التقويم المطلوب الاشتراك فيه

العملية

عمليات التعداد
OPERATION_UNSPECIFIED
CREATE

ConferenceDataMarkup

ترميز يحدّد بيانات الاجتماع المرتبطة بحدث في "تقويم Google" لا يمكن إنشاء إضافات مكالمات الفيديو التابعة لجهات خارجية إلا في برمجة تطبيقات Google.

الحقول
conferenceId

string

المعرّف الفريد لبيانات الاجتماع هذه الحد الأقصى للطول هو 512 حرفًا.

entryPoints[]

EntryPointMarkup

نقاط الدخول إلى المؤتمر يُسمح بـ 300 نقطة دخول كحدّ أقصى.

parameters[]

Parameter

مَعلمات إضافية للإضافة يُسمح بـ 300 مَعلمة كحدّ أقصى.

error

Error

في حال ضبط هذه السمة، يعني ذلك حدوث خطأ أثناء إنشاء الاجتماع.

note

string

ملاحظات إضافية (مثل تعليمات من المشرف أو إشعارات قانونية) لعرضها للمستخدم يمكن أن يحتوي على HTML. الحد الأقصى للطول هو 2048 حرفًا.

conferenceSolutionId

string

معرّف المنصة لمكالمات الفيديو يجب أن يتطابق مع قيمة من حقل calendar.conferenceSolution.id الخاص بالنشر.

EntryPointMarkup

طريقة للانضمام إلى المؤتمر لا يمكن إنشاء إضافات مكالمات الفيديو التابعة لجهات خارجية إلا في برمجة تطبيقات Google.

الحقول
type

Type

نوع نقطة الدخول الحقل مطلوب.

uri

string

معرّف موارد منتظم (URI) للانضمام إلى الاجتماع يجب أن يتوافق مع tel: ‎ وhttp(s): ‎ وألا يزيد طوله عن 1300 حرف. الحقل مطلوب.

label

string

تصنيف نقطة الدخول التي ستظهر للمستخدم الحد الأقصى للطول هو 512 حرفًا.

meetingCode

string

رمز اجتماع للوصول إلى مكالمة الفيديو الحد الأقصى للطول هو 128 حرفًا.

accessCode

string

رمز دخول للوصول إلى الاجتماع الحد الأقصى للطول هو 128 حرفًا.

passcode

string

رمز مرور للوصول إلى المؤتمر الحد الأقصى للطول هو 128 حرفًا.

password

string

كلمة مرور للوصول إلى الاجتماع الحد الأقصى للطول هو 128 حرفًا.

pin

string

رقم تعريف شخصي للوصول إلى المؤتمر الحد الأقصى للطول هو 128 حرفًا.

regionCode

string

رمز المنطقة CLDR/ISO 3166 للبلد المرتبط بنقطة الدخول هذه. ينطبق ذلك على Type.PHONE فقط.

features[]

Feature

ميزات نقطة الدخول، مثل كونها طريقًا برسوم أو طريقًا مجانيًا يمكن أن تتضمّن نقطة دخول واحدة ميزات متعدّدة.

الميزة

ميزات نقطة الدخول قد تنطبق بعض الميزات على نقاط دخول معيّنة فقط.

عمليات التعداد
UNKNOWN_FEATURE الميزة غير معروفة.
TOLL ينطبق ذلك على نقطة دخول واحدة (PHONE). يتم احتساب رسوم المكالمة على رقم غير مجاني على الطرف المتصل. لا يمكن أن يكون الرقم مجانيًا وغير مجاني في الوقت نفسه.
TOLL_FREE ينطبق ذلك على نقطة دخول واحدة (PHONE). بالنسبة إلى المتصل، تكون المكالمة برقم اتصال مجاني بدون أي تكلفة. لا يمكن أن يكون الرقم مجانيًا وغير مجاني في الوقت نفسه.

النوع

نوع نقطة الدخول لا يمكن إنشاء إضافات مكالمات الفيديو التابعة لجهات خارجية إلا في برمجة تطبيقات Google.

عمليات التعداد
UNKNOWN نوع الاجتماع غير معروف.
VIDEO اجتماع فيديو
PHONE مؤتمر عبر الهاتف
MORE يُستخدَم لتوفير رابط يؤدي إلى مزيد من المعلومات حول الانضمام إلى الاجتماع.
SIP اجتماع باستخدام بروتوكول بدء الجلسة

خطأ

يمثّل خطأ حدث أثناء إنشاء الاجتماع. لا يمكن إنشاء إضافات مكالمات الفيديو التابعة لجهات خارجية إلا في برمجة تطبيقات Google.

الحقول
type

Type

نوع الخطأ الحقل مطلوب.

authenticationUrl

string

إذا كان نوع الخطأ هو AUTHENTICATION، يمكن أن توفّر الإضافة عنوان URL يسمح للمستخدمين بتسجيل الدخول. يجب ألا يزيد طوله عن 1,300 حرف.

النوع

عمليات التعداد
UNKNOWN حدث خطأ غير معروف.
AUTHENTICATION خطأ في المصادقة
TEMPORARY حدث خطأ مؤقت.
PERMANENT خطأ دائم
PERMISSION_DENIED لا يُسمح للمستخدم بتنفيذ بعض الإجراءات في نظام مكالمات الفيديو التابع لجهة خارجية.
CONFERENCE_SOLUTION_FORBIDDEN لا يُسمح للمستخدم باستخدام منصة مكالمات الفيديو المحدّدة (ولكن قد يُسمح له باستخدام منصات أخرى توفّرها الإضافة).

المَعلمة

المَعلمات الخاصة بالحلول التي يتم الاحتفاظ بها مع بيانات الأحداث، وإذا كانت هناك حاجة إلى تعديل أو حذف، يتم تمريرها إلى الإضافة. مثلاً: [{key: 'sessionKey', value: '123'}, {key: 'meetingId', value: '456'}]

الحقول
key

string

مفتاح المَعلمة يجب ألا يزيد طوله عن 50 حرفًا. الحقل مطلوب.

value

string

قيمة المَعلمة الحد الأقصى للطول هو 1024 حرفًا. الحقل مطلوب.

CreateConferenceDataActionMarkup

الحقول
createConferenceData

ConferenceDataMarkup

بيانات الاجتماع المطلوب إضافتها إلى حدث في "تقويم Google" عند إنشائه

CreateConferenceSettingUrlActionMarkup

الحقول
settingsUrl

string

تمثّل هذه السمة معرّف الموارد المنتظم (URI) لصفحة الإعدادات التي أنشأتها الإضافة.

EditAttendeesActionMarkup

الحقول
addAttendeeEmails[]

string

قائمة بالمشاركين المطلوب إضافتهم إلى الحدث في "تقويم Google".

EditConferenceDataActionMarkup

الحقول

حقل الربط conference

يمكن أن يكون التعليق conference إحدى القيم التالية فقط:

conferenceData

ConferenceDataMarkup

بيانات الاجتماع المطلوب إضافتها إلى حدث في "تقويم Google" لا يمكن إنشاء إضافات مكالمات الفيديو التابعة لجهات خارجية إلا في برمجة تطبيقات Google.

ChatClientDataSourceMarkup

بالنسبة إلى تطبيق مصغّر SelectionInput يستخدم قائمة اختيار متعدد، يكون مصدر البيانات من Google Chat. يملأ مصدر البيانات عناصر الاختيار لقائمة الاختيار المتعدّد. على سبيل المثال، يمكن للمستخدم اختيار مساحات Google Chat التي يكون عضوًا فيها.

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

الحقول
حقل الربط source مصدر بيانات Google Chat يمكن أن يكون التعليق source إحدى القيم التالية فقط:
spaceDataSource

SpaceDataSource

مساحات Google Chat التي يكون المستخدم عضوًا فيها

SpaceDataSource

مصدر بيانات يملأ مساحات Google Chat كعناصر اختيار لقائمة الاختيار المتعدّد يتم ملء المساحات التي يكون المستخدم عضوًا فيها فقط.

متاحة لتطبيقات Google Chat وغير متاحة لإضافات Google Workspace.

الحقول
defaultToCurrentSpace

bool

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

ChatDataActionMarkup

ينشئ هذا الإجراء رسالة أو يعدّلها في Google Chat. لمعرفة التفاصيل، يُرجى الاطّلاع على إنشاء واجهات Google Chat.

الحقول
حقل الربط action إجراء في Google Chat يمكن أن يكون التعليق action إحدى القيم التالية فقط:
createMessageAction

CreateMessageAction

لإرسال رسالة كتطبيق Google Chat

updateMessageAction

UpdateMessageAction

تعديل رسالة تطبيق Google Chat

updateInlinePreviewAction

UpdateInlinePreviewAction

لمعاينة الروابط، يضيف التطبيق بطاقة واحدة أو أكثر إلى رسالة مستخدم Google Chat.

CreateMessageAction

يرسل تطبيق Chat رسالة. لمعرفة التفاصيل، يُرجى الاطّلاع على المقالة إرسال رسائل محادثة في Google Chat.

الحقول
message

Message

رسالة Google Chat

UpdateInlinePreviewAction

يعاين تطبيق Chat رابطًا في رسالة من خلال إضافة بطاقة واحدة أو أكثر أو تعديلها. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة معاينة الروابط في رسائل محادثة Google Chat.

الحقول
cardsV2[]

CardWithId

مصفوفة من بطاقة واحدة أو أكثر

UpdateMessageAction

يعدّل تطبيق Chat النص أو البطاقات في رسالة. لمعرفة التفاصيل، يُرجى الاطّلاع على المقالة إرسال رسائل محادثة في Google Chat.

الحقول
message

Message

الرسالة المعدَّلة

DriveClientActionMarkup

الحقول
requestFileScope

RequestFileScope

RequestFileScope

الحقول
itemId

string

EditorClientActionMarkup

الحقول

حقل الربط action

يمكن أن يكون التعليق action إحدى القيم التالية فقط:

requestFileScopeForActiveDocument

RequestFileScopeForActiveDocument

RequestFileScopeForActiveDocument

هذا النوع لا يحتوي على حقول.

GmailClientActionMarkup

الحقول

حقل الربط type

يمكن أن يكون التعليق type إحدى القيم التالية فقط:

taskAction

TaskActionMarkup

updateDraftActionMarkup

UpdateDraftActionMarkup

openCreatedDraftActionMarkup

OpenCreatedDraftActionMarkup

addonComposeUiActionMarkup

AddonComposeUiActionMarkup

AddonComposeUiActionMarkup

الحقول
type

AddonComposeUiActionType

AddonComposeUiActionType

عمليات التعداد
UNSPECIFIED تلقائي: في حال عدم تحديد أي إجراء، لن يتم اتّخاذ أي إجراء.
DISMISS لإغلاق واجهة مستخدم الإنشاء الخاصة بالإضافة

OpenCreatedDraftActionMarkup

الحقول
draftId

string

رقم تعريف المسودة التي تم إنشاؤها حديثًا في النموذج "r123".

draftStorageId

string

رقم تعريف مساحة التخزين على الخادم بتنسيق سداسي عشري، على سبيل المثال، "15e9fa622ce1029d".

draftThreadServerPermId

string

المعرّف الدائم لسلسلة محادثات المسودة على الخادم. لا يتم ضبط هذا الحقل في أي مكان، ويتم تجاهله عند معالجة OpenCreatedDraftActionMarkup. يُرجى تقديم draftThreadStorageId واستخدامه بدلاً من ذلك.

draftThreadId

string

معرّف سلسلة المحادثات التي تحتوي على المسودة التي تم إنشاؤها حديثًا، على سبيل المثال، "15e9fa622ce1029d".

TaskActionMarkup

الحقول
reloadTasks

bool

UpdateDraftActionMarkup

الحقول
updateBody

UpdateBody

حقل يحتوي على سلسلة من إجراءات التعديل التي يتم تنفيذها على نص المسودة الذي يعدّله المستخدم حاليًا.

updateToRecipients

UpdateToRecipients

في حال ضبط هذه السياسة، يتم استبدال المستلِمين الحاليين في الحقل "إلى" في المسودة التي يعدّلها المستخدم حاليًا.

updateCcRecipients

UpdateCcRecipients

في حال ضبط هذه السياسة، يتم استبدال مستلِمي نسخة طبق الأصل الحاليين من المسودة التي يعدّلها المستخدم حاليًا.

updateBccRecipients

UpdateBccRecipients

في حال ضبط هذه السياسة، يتم استبدال مستلِمي نسخة مخفية الوجهة الحاليين في المسودة التي يعدّلها المستخدم حاليًا.

updateSubject

UpdateSubject

في حال ضبط هذه السمة، يتم استبدال الموضوع الحالي للمسودة التي يعدّلها المستخدم حاليًا.

المستلم

الحقول
email

string

UpdateBccRecipients

الحقول
bccRecipients[]

Recipient

UpdateBody

الحقول
insertContents[]

InsertContent

حقل متكرّر يحتوي على سلسلة من المحتوى لإدراجه في المسودة التي يعدّلها المستخدم حاليًا يمكن أن يتضمّن المحتوى محتوى HTML أو محتوى نصيًا عاديًا.

type

Type

ContentType

عمليات التعداد
UNSPECIFIED_CONTENT_TYPE القيمة التلقائية في حال عدم ضبط أي قيمة لـ ContentType
TEXT تحدّد أنّ المحتوى هو نص عادي.
MUTABLE_HTML يحدّد أنّ المحتوى بتنسيق HTML وقابل للتغيير (يمكن تعديله).
IMMUTABLE_HTML يحدّد أنّ المحتوى بتنسيق HTML وغير قابل للتغيير (لا يمكن تعديله).

EmailMimeType

تم إيقاف EmailMimeType نهائيًا. يُرجى استخدام ContentType.

عمليات التعداد
UNSPECIFIED_EMAIL_MIME_TYPE القيمة التلقائية في حال عدم ضبط أي قيمة لـ EmailMimeType.
PLAIN_TEXT يحدّد أنّ المحتوى الذي تم إدراجه هو نص عادي.
HTML تحدّد أنّ المحتوى الذي تم إدراجه بتنسيق HTML.

InsertContent

الحقول
content

string

المحتوى المطلوب إدراجه

mimeType
(deprecated)

EmailMimeType

contentType

ContentType

نوع المحتوى الذي تم إدراجه

النوع

عمليات التعداد
UNSPECIFIED_ACTION_TYPE القيمة التلقائية في حال عدم ضبط أي قيمة لـ "النوع".
IN_PLACE_INSERT يشير هذا إلى أنّ هذا الإجراء مخصّص لإجراء إدراج في الموضع. يتم إدراج المحتوى تلقائيًا في موضع المؤشر الحالي، وإذا كان هناك محتوى محدّد، يتم استبداله.
INSERT_AT_START يشير هذا إلى أنّ هذا الإجراء مخصّص لإجراء الإدراج في بداية نص الرسالة.
INSERT_AT_END يشير هذا إلى أنّ هذا الإجراء مخصّص لإدراج المحتوى في نهاية نص الرسالة.
REPLACE يشير إلى أنّ هذا الإجراء يهدف إلى استبدال نص الرسالة.

UpdateCcRecipients

الحقول
ccRecipients[]

Recipient

UpdateSubject

الحقول
subject

string

UpdateToRecipients

الحقول
toRecipients[]

Recipient

HostAppActionMarkup

الإجراءات التي تعالجها تطبيقات المضيف الفردية

الحقول

حقل الربط action

يمكن أن يكون التعليق action إحدى القيم التالية فقط:

gmailAction

GmailClientActionMarkup

الإجراءات التي يعالجها Gmail

calendarAction

CalendarClientActionMarkup

الإجراءات التي يعالجها "تقويم Google"

driveAction

DriveClientActionMarkup

الإجراءات التي يعالجها Drive

editorAction

EditorClientActionMarkup

الإجراءات التي تتم معالجتها من خلال "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google"

sheetsAction

SheetsClientActionMarkup

الإجراءات التي تعالجها "جداول بيانات Google"

workflowAction

WorkflowClientActionMarkup

الإجراءات التي يعالجها Workspace Studio

HostAppDataActionMarkup

يحدّد كيفية تعديل بيانات Google Workspace.

الحقول
حقل الربط action إجراء الإضافة لتطبيق مضيف معيّن في Google Workspace يمكن أن يكون التعليق action إحدى القيم التالية فقط:
chatDataAction

ChatDataActionMarkup

إجراء Google Chat ينشئ أو يعدّل نصًا أو بطاقات في رسالة.

HostAppDataSourceMarkup

مصدر بيانات من تطبيق Google Workspace يملأ مصدر البيانات العناصر المتاحة لأداة.

الحقول
حقل الربط data_source تطبيق Google Workspace الذي يملأ العناصر المتاحة لودجت معيّن. يمكن أن يكون التعليق data_source إحدى القيم التالية فقط:
chatDataSource

ChatClientDataSourceMarkup

مصدر بيانات من Google Chat

workflowDataSource

WorkflowDataSourceMarkup

مصدر بيانات من Google Workflow

SheetsClientActionMarkup

رقم التعريف التالي: 5.

الحقول

حقل الربط action

يمكن أن يكون التعليق action إحدى القيم التالية فقط:

customFunctionReturnValueMarkup

CustomFunctionReturnValueMarkup

CustomFunctionReturnValueMarkup

نتيجة تشغيل مستخدم لدالة مخصّصة

الحقول
حقل الربط result نتيجة تنفيذ الدالة المخصّصة يمكن أن يكون التعليق result إحدى القيم التالية فقط:
value

Value

القيمة الناتجة عن تشغيل الدالة المخصّصة

errorMessage

string

رسالة الخطأ التي ستظهر للمستخدم في حال حدوث خطأ

WorkflowClientActionMarkup

إجراءات العميل لإضافات Workspace Studio

الحقول

حقل الربط action

يمكن أن يكون التعليق action إحدى القيم التالية فقط:

saveWorkflowAction

SaveWorkflowAction

إجراء لبدء حفظ سير العمل

returnOutputVariablesAction

ReturnOutputVariablesAction

إجراء يحتوي على متغيّرات ناتجة عن إجراء سير عمل تم تنفيذه.

resourceRetrievedAction

ResourceRetrievedAction

إجراء يحتوي على مورد تم استرداده

resourceFieldsDefinitionRetrievedAction

ResourceFieldsDefinitionRetrievedAction

إجراء يحتوي على تعريف الحقول لمورد معيّن

returnElementErrorAction

ReturnElementErrorAction

إجراء يشير إلى حدوث خطأ أثناء استدعاء العنصر

workflowValidationErrorAction

WorkflowValidationErrorAction

إجراء يشير إلى خطأ في التحقّق من سير العمل

ResourceData

قيمة المورد الخاصة بالتطبيق

الحقول
fields

map<string, VariableData>

خريطة لحقول المورد التي تم إدخالها حسب اسم الحقل.

sourceResourceReference
(deprecated)

SourceResourceReference

تمّ الإيقاف. يُرجى استخدام VariableData.variable_source_data بدلاً من ذلك.

ResourceFieldsDefinitionRetrievedAction

يحتوي على تعريف كل حقل يوفّره المورد.

الحقول
dynamicResourceDefinitions[]

DynamicResourceDefinition

تعريفات الموارد الديناميكية

DynamicResourceDefinition

يحتوي على تعريف كل حقل يوفّره مورد ديناميكي.

الحقول
resourceId

string

المعرّف الفريد لنوع المورد الديناميكي، مثل "FORM_RESPONSE_VALUES"

fields[]

ResourceField

قائمة بالحقول التي يتيحها هذا المورد الديناميكي

ResourceField

الحقول
selector

string

مفتاح مرجع الحقل المستخدَم لاسترداد القيمة المرتبطة به

displayText

string

الوصف الذي يمكن لشخص عادي قراءته للحقل الذي يظهر للمستخدم النهائي أثناء اختيار المتغيّر.

dataType

DataType

نوع بيانات الحقل

cardinality

Cardinality

عدد العناصر في الحقل

ResourceRetrievedAction

يحتوي على المرجع الذي تم إرجاعه.

الحقول
resourceData

ResourceData

بيانات مخصّصة بتنسيق proto

ReturnElementErrorAction

يشير إلى حدوث خطأ أثناء استدعاء العنصر.

الحقول
developerErrorMessage

string

رسالة خطأ موجّهة للمطوّرين

errorLog

WorkflowTextFormatMarkup

رسالة الخطأ التي يمكن لشخص عادي قراءتها والتي ستظهر للمستخدم النهائي.

errorActionability

ErrorActionability

ما إذا كان الخطأ قابلاً للتنفيذ من قِبل المستخدم.

retryability

Retryability

ما إذا كان الخطأ قابلاً لإعادة المحاولة أم لا

ErrorActionability

ما إذا كان بإمكان المستخدم محاولة إصلاح الخطأ

عمليات التعداد
ERROR_ACTIONABILITY_UNSPECIFIED إمكانية اتخاذ إجراء بشأن خطأ غير محدَّد. لا تستخدمه.
ACTIONABLE يمكن للمستخدم محاولة إصلاح الخطأ.
NOT_ACTIONABLE لا يمكن للمستخدم إصلاح الخطأ.

إمكانية إعادة المحاولة

ما إذا كان الخطأ قابلاً لإعادة المحاولة أم لا

عمليات التعداد
RETRYABILITY_UNSPECIFIED لم يتم تحديد إمكانية إعادة المحاولة. لا تستخدمه.
RETRYABLE يمكن إعادة محاولة معالجة الخطأ.
NOT_RETRYABLE لا يمكن إعادة محاولة معالجة الخطأ.

ReturnOutputVariablesAction

يحتوي على متغيّرات الناتج التي تم إنشاؤها من خلال إجراء سير العمل الذي تم تنفيذه.

الحقول
variables

map<string, VariableData>

تمثيل للمتغيّرات حسب رقم تعريف المتغيّر

log

WorkflowTextFormatMarkup

سجلّ إجراء سير العمل الذي تم تنفيذه

SaveWorkflowAction

هذا النوع لا يحتوي على حقول.

تشير إلى أنّه يجب أن تبدأ أداة الإنشاء في حفظ سير العمل.

SourceResourceReference

يشير إلى مثيل محدّد من مرجع Workspace

الحقول
sourceResourceType

SourceResourceType

نوع المورد المصدر

resourceId

string

المعرّف الفريد للمرجع (مثل معرّف ملف Drive أو معرّف رسالة Gmail)

SourceResourceType

نوع المورد المصدر يُستخدَم هذا الحقل لتحديد نوع المورد وحزمة سير العمل التي تملك نوع المورد.

الحقول
workflowBundleId

string

رقم تعريف حزمة سير العمل التي تملك نوع المورد هذا

resourceDefinitionId

string

رقم تعريف تعريف المورد ضمن الحزمة (مثل "spreadsheet" أو "gmailMessage")

VariableData

تمثّل بيانات متغيّرة يمكن أن تحتوي على قيم متعدّدة من أنواع مختلفة.

الحقول
booleanValues[]

bool

القيم المنطقية

integerValues[]

int64

قيم الأعداد الصحيحة

stringValues[]

string

قيم السلاسل

timestampValues[]

Timestamp

قيم الطابع الزمني

resourceReferences[]

string

قائمة بأرقام تعريف الموارد (مثل "spaces/123")

resourceDataValues[]

ResourceData

بيانات الموارد:

emailAddressValues[]

string

قيم عناوين البريد الإلكتروني

googleUserValues[]

string

قيم مستخدمي Google بالتنسيق users/{user}.

textFormatValues[]

WorkflowTextFormatMarkup

قيم تنسيق النص في سير العمل

WorkflowValidationErrorAction

يشير ذلك إلى تعذُّر التحقّق من صحة عنصر سير العمل بمستوى الخطورة المحدّد.

الحقول
severity

Severity

مستوى خطورة خطأ التحقّق

درجة الخطورة

عمليات التعداد
SEVERITY_UNSPECIFIED مستوى الخطورة غير محدّد. لا تستخدمه.
WARNING الخطأ غير خطير ولا يمنع النشر.
CRITICAL هذا الخطأ خطير ويجب إصلاحه قبل النشر.

WorkflowDataSourceMarkup

* لا تتوافق إلا مع Google Workspace Workflow، ولكنّها لا تتوافق مع تطبيقات Google Chat أو إضافات Google Workspace.

في تطبيق مصغّر من النوع TextInput أو SelectionInput من النوع MULTI_SELECT أو DateTimePicker، قدِّم مصدر البيانات من Google.

الحقول
includeVariables

bool

ما إذا كان سيتم تضمين المتغيّرات من الخطوة السابقة في مصدر البيانات.

type

Type

نوع مصدر البيانات

النوع

قائمة تعداد تمثّل نوع مصدر بيانات سير العمل

عمليات التعداد
UNKNOWN القيمة التلقائية يجب عدم استخدامها.
USER مستخدمو Google Workspace يمكن للمستخدم الاطّلاع على المستخدمين واختيارهم من مؤسسته على Google Workspace فقط.
SPACE مساحات Google Chat التي يكون المستخدم عضوًا فيها
USER_WITH_FREE_FORM يمكن للمستخدمين اختيار عرض الأعضاء الحاليين واختيارهم من مؤسستهم على Google Workspace أو إدخال عنوان بريد إلكتروني أو نطاق صالح يدويًا.

WorkflowTextFormatMarkup

مجموعة نصية تتضمّن خيارات تنسيق متقدّمة، بما في ذلك الأنماط والروابط التشعّبية والعناصر التفاعلية

الحقول
textFormatElements[]

TextFormatElement

مجموعة من عناصر تنسيق النص

شريحة

شريحة قابلة للنقر بتنسيق نصي

الحقول
icon

Icon

الرمز المعروض في الشريحة

label

string

النص المعروض في الشريحة

url

string

عنوان URL الذي يتم الانتقال إليه عند النقر على الشريحة

رمز

رمز في الشريحة

الحقول
حقل الربط icons الرمز المعروض في الشريحة يمكن أن يكون التعليق icons إحدى القيم التالية فقط:
iconUrl

string

عرض رمز مخصّص مستضاف على عنوان URL يستخدم HTTPS

على سبيل المثال:

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

تشمل أنواع الملفات المتوافقة .png و.jpg.

materialIconName

string

اسم الرمز المحدّد في رمز متوافق مع إرشادات التصميم المتعدّد الأبعاد من Google، على سبيل المثال، check_box. يتم تجاهل أي أسماء غير صالحة واستبدالها بسلسلة فارغة، ما يؤدي إلى تعذُّر عرض الرمز.

TextFormatElement

عنصر واحد ضمن رسالة WorkflowTextFormatMarkup، ويمكن أن يكون شريحة أو نصًا منسقًا أو رابطًا تشعبيًا أو حاوية قائمة.

الحقول
حقل الربط element عنصر يمثّل أحد عناصر تنسيق النص المتعددة المحتملة يمكن أن يكون التعليق element إحدى القيم التالية فقط:
text

string

النص بالتنسيق النصي

chip

Chip

شريحة قابلة للنقر بتنسيق نصي

styledText

StyledText

نص منمّق بتنسيق النص

listContainer

ListContainer

حاوية القائمة بالتنسيق النصي

ListContainer

حاوية لعناصر القائمة، حيث يمكن أن يحتوي كل عنصر قائمة على عدة عناصر TextFormatElement.

الحقول
listNestLevel

int64

مستوى دمج القائمة يبدأ من 0 للمستوى الأعلى، ويزيد بمقدار 1 لكل قائمة متداخلة.

listType

ListType

نوع القائمة

listItems[]

ListItem

مجموعة من عناصر القائمة

ListItem

عنصر قائمة

الحقول
textFormatElements[]

TextFormatElement

مجموعة من عناصر تنسيق النص

ListType

قائمة تعداد لأنواع القوائم المختلفة

عمليات التعداد
LIST_TYPE_UNSPECIFIED لم يتم تحديد نوع القائمة.
ORDERED قائمة مع ترتيب
UNORDERED قائمة بدون ترتيب
BLOCKQUOTE قائمة اقتباسات الفقرات

StyledText

عنصر نصي يتضمّن أنماطًا مثل الخط الغامق والمائل واللون

الحقول
text

string

المحتوى الرئيسي للنص

styles[]

Style

مجموعة من الأنماط المطبَّقة على النص

fontWeight

FontWeight

عرض خط النص

color

Color

لون النص

wrapStyle

WrapStyle

نمط التفاف النص

FontWeight

قائمة تعداد لأوزان الخطوط المختلفة

عمليات التعداد
FONT_WEIGHT_UNSPECIFIED وزن عادي وسُمك عادي
LIGHT وزن أخفّ وسُمك أقلّ
MEDIUM وزن متوسط بين الفاتح والغامق.
BOLD وزن أثقل مع زيادة السُمك

النمط

Enum لأنماط النصوص المختلفة، مثل المائل والمسطر وما إلى ذلك.

عمليات التعداد
STYLE_UNSPECIFIED لم يتم تطبيق أي نمط.
ITALIC نمط مائل
UNDERLINE نمط التسطير
STRIKETHROUGH نمط النص المشطوب
LINE_BREAK فاصل سطر
UPPERCASE نمط الأحرف الكبيرة
CODE الرمز
CODE_BLOCK مجموعة رموز

WrapStyle

تعداد لأنماط الالتفاف المختلفة

عمليات التعداد
WRAP_STYLE_UNSPECIFIED لم يتم تحديد نمط التفاف.
NO_WRAP بلا نمط التفاف