Package apps.extensions.markup

الفهرس

CalendarClientActionMarkup

الحقول
editAttendeesActionMarkup

EditAttendeesActionMarkup

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

editConferenceDataActionMarkup

EditConferenceDataActionMarkup

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

addAttachmentsActionMarkup

AddAttachmentsActionMarkup

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

AddAttachmentsActionMarkup

الحقول
addonAttachments[]

AddonAttachment

AddonAttachment

الحقول
resourceUrl

string

title

string

عنوان المرفق.

mimeType

string

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

iconUrl

string

أدخِل رابطًا يؤدي إلى رمز المرجع.

ConferenceDataMarkup

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

الحقول
conferenceId

string

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

entryPoints[]

EntryPointMarkup

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

parameters[]

Parameter

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

error

Error

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

note

string

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

conferenceSolutionId

string

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

EntryPointMarkup

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

الحقول
type

Type

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

uri

string

معرّف موارد منتظم للانضمام إلى المؤتمر يتوافق مع 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. تكون المكالمة إلى رقم مجاني مجانية للطرف المتصل. لا يمكن أن يكون الرقم مدفوعًا ومجانيًا في الوقت نفسه.

النوع

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

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

خطأ

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

الحقول
type

Type

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

authenticationUrl

string

إذا كان نوع الخطأ هو AUTHENTICATION، يمكن أن تقدّم الإضافة عنوان URL يسمح للمستخدمين بتسجيل الدخول. الحد الأقصى لعدد الأحرف هو 1300 حرف.

النوع

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

المَعلمة

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

الحقول
key

string

مفتاح المَعلمة الحد الأقصى 50 حرفًا. مطلوب.

value

string

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

EditAttendeesActionMarkup

الحقول
addAttendeeEmails[]

string

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

EditConferenceDataActionMarkup

الحقول

حقل الربط conference

يمكن أن يكون conference واحدًا فقط مما يلي:

conferenceData

ConferenceDataMarkup

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

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"

HostAppDataActionMarkup

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

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

ChatDataActionMarkup

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

HostAppDataSourceMarkup

بالنسبة إلى تطبيق مصغّر SelectionInput يستخدم قائمة اختيار متعدّد، يجب توفير مصدر بيانات من تطبيق Google Workspace. يعبّئ مصدر البيانات عناصر الاختيار لقائمة الاختيار المتعدّد.

تتوفّر هذه الميزة لتطبيقات Google Chat ولا تتوفّر لإضافات Google Workspace.

الحقول
حقل الربط data_source تطبيق Google Workspace الذي يعبّئ العناصر لقائمة متعددة الاختيارات يمكن أن يكون data_source واحدًا فقط مما يلي:
chatDataSource

ChatClientDataSourceMarkup

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

SheetsClientActionMarkup

الحقول
customFunctionReturnValueMarkup

CustomFunctionReturnValueMarkup

CustomFunctionReturnValueMarkup

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

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

Value

القيمة الناتجة عن تنفيذ الدالة المخصّصة.

errorMessage

string

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