Package apps.extensions.markup

الفهرس

CalendarClientActionMarkup

الحقول
editAttendeesActionMarkup

EditAttendeesActionMarkup

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

editConferenceDataActionMarkup

EditConferenceDataActionMarkup

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

addAttachmentsActionMarkup

AddAttachmentsActionMarkup

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

createConferenceDataActionMarkup

CreateConferenceDataActionMarkup

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

createConferenceSettingUrlActionMarkup

CreateConferenceSettingUrlActionMarkup

إجراء ينشئ عنوان URL لإعداد createconference.

calendarSubscriptionActionMarkup

CalendarSubscriptionActionMarkup

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

AddAttachmentsActionMarkup

الحقول
addonAttachments[]

AddonAttachment

AddonAttachment

الحقول
resourceUrl

string

title

string

تمثّل هذه السمة عنوان المرفق.

mimeType

string

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

iconUrl

string

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

CalendarSubscriptionActionMarkup

الحقول
operation

Operation

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

calendarId

string

معرّف التقويم الذي تريد الاشتراك فيه.

العملية

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

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

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

النوع

تمثّل هذه السمة نوع نقطة الدخول. لا يمكن إنشاء إضافات لمكالمات الفيديو تابعة لجهات خارجية إلا في 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 حرفًا. الحقل مطلوب.

CreateConferenceDataActionMarkup

الحقول
createConferenceData

ConferenceDataMarkup

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

CreateConferenceSettingUrlActionMarkup

الحقول
settingsUrl

string

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

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، ستختار قائمة الاختيار المتعدد مساحة Chat الحالية في Google كعنصر تلقائيًا.

ChatDataActionMarkup

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

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

CreateMessageAction

إرسال رسالة كتطبيق محادثات Google Chat

updateMessageAction

UpdateMessageAction

تعدِّل هذه الطريقة رسالة تطبيق Google Chat.

updateInlinePreviewAction

UpdateInlinePreviewAction

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

CreateMessageAction

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

الحقول
message

Message

رسالة Google Chat

UpdateInlinePreviewAction

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

الحقول
cardsV2[]

CardWithId

مصفوفة تحتوي على بطاقة واحدة أو أكثر

UpdateMessageAction

يعدّل تطبيق محادثات النص أو البطاقات في الرسالة. لمزيد من التفاصيل، يُرجى الاطّلاع على إرسال رسائل 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

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

draftThreadServerPermId

string

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

draftThreadId

string

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

TaskActionMarkup

الحقول
reloadTasks

bool

UpdateDraftActionMarkup

الحقول
updateBody

UpdateBody

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

updateToRecipients

UpdateToRecipients

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

updateCcRecipients

UpdateCcRecipients

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

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

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

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

ChatClientDataSourceMarkup

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

SheetsClientActionMarkup

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

الحقول

حقل الدمج action

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

customFunctionReturnValueMarkup

CustomFunctionReturnValueMarkup

CustomFunctionReturnValueMarkup

نتيجة تنفيذ المستخدم لدالة مخصّصة

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

Value

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

errorMessage

string

رسالة الخطأ التي ستُعرض للمستخدم في حال حدوث مشكلة.