الفهرس
ChatService
(واجهة)AccessoryWidget
(رسالة)ActionResponse
(رسالة)ActionResponse.ResponseType
(تعداد)ActionResponse.SelectionItems
(رسالة)ActionResponse.UpdatedWidget
(رسالة)ActionStatus
(رسالة)Annotation
(رسالة)AnnotationType
(تعداد)AttachedGif
(رسالة)Attachment
(رسالة)Attachment.Source
(تعداد)AttachmentDataRef
(رسالة)CardWithId
(رسالة)ChatSpaceLinkData
(رسالة)CompleteImportSpaceRequest
(رسالة)CompleteImportSpaceResponse
(رسالة)ContextualAddOnMarkup
(رسالة)ContextualAddOnMarkup.Card
(رسالة)ContextualAddOnMarkup.Card.CardAction
(رسالة)ContextualAddOnMarkup.Card.CardHeader
(رسالة)ContextualAddOnMarkup.Card.CardHeader.ImageStyle
(تعداد)ContextualAddOnMarkup.Card.Section
(رسالة)CreateCustomEmojiRequest
(رسالة)CreateMembershipRequest
(رسالة)CreateMessageRequest
(رسالة)CreateMessageRequest.MessageReplyOption
(تعداد)CreateReactionRequest
(رسالة)CreateSpaceRequest
(رسالة)CustomEmoji
(رسالة)CustomEmoji.CustomEmojiPayload
(رسالة)DeleteCustomEmojiRequest
(رسالة)DeleteMembershipRequest
(رسالة)DeleteMessageRequest
(رسالة)DeleteReactionRequest
(رسالة)DeleteSpaceRequest
(رسالة)DeletionMetadata
(رسالة)DeletionMetadata.DeletionType
(تعداد)Dialog
(رسالة)DialogAction
(رسالة)DriveDataRef
(رسالة)DriveLinkData
(رسالة)Emoji
(رسالة)EmojiReactionSummary
(رسالة)FindDirectMessageRequest
(رسالة)GetAttachmentRequest
(رسالة)GetCustomEmojiRequest
(رسالة)GetMembershipRequest
(رسالة)GetMessageRequest
(رسالة)GetSpaceEventRequest
(رسالة)GetSpaceNotificationSettingRequest
(رسالة)GetSpaceReadStateRequest
(رسالة)GetSpaceRequest
(رسالة)GetThreadReadStateRequest
(رسالة)Group
(رسالة)HistoryState
(تعداد)ListCustomEmojisRequest
(رسالة)ListCustomEmojisResponse
(رسالة)ListMembershipsRequest
(رسالة)ListMembershipsResponse
(رسالة)ListMessagesRequest
(رسالة)ListMessagesResponse
(رسالة)ListReactionsRequest
(رسالة)ListReactionsResponse
(رسالة)ListSpaceEventsRequest
(رسالة)ListSpaceEventsResponse
(رسالة)ListSpacesRequest
(رسالة)ListSpacesResponse
(رسالة)MatchedUrl
(رسالة)Membership
(رسالة)Membership.MembershipRole
(تعداد)Membership.MembershipState
(تعداد)MembershipBatchCreatedEventData
(رسالة)MembershipBatchDeletedEventData
(رسالة)MembershipBatchUpdatedEventData
(رسالة)MembershipCreatedEventData
(رسالة)MembershipDeletedEventData
(رسالة)MembershipUpdatedEventData
(رسالة)Message
(رسالة)MessageBatchCreatedEventData
(رسالة)MessageBatchDeletedEventData
(رسالة)MessageBatchUpdatedEventData
(رسالة)MessageCreatedEventData
(رسالة)MessageDeletedEventData
(رسالة)MessageUpdatedEventData
(رسالة)QuotedMessageMetadata
(رسالة)Reaction
(رسالة)ReactionBatchCreatedEventData
(رسالة)ReactionBatchDeletedEventData
(رسالة)ReactionCreatedEventData
(رسالة)ReactionDeletedEventData
(رسالة)RichLinkMetadata
(رسالة)RichLinkMetadata.RichLinkType
(تعداد)SearchSpacesRequest
(رسالة)SearchSpacesResponse
(رسالة)SetUpSpaceRequest
(رسالة)SlashCommand
(رسالة)SlashCommandMetadata
(رسالة)SlashCommandMetadata.Type
(تعداد)Space
(رسالة)Space.AccessSettings
(رسالة)Space.AccessSettings.AccessState
(تعداد)Space.MembershipCount
(رسالة)Space.PermissionSetting
(رسالة)Space.PermissionSettings
(رسالة)Space.PredefinedPermissionSettings
(تعداد)Space.SpaceDetails
(رسالة)Space.SpaceThreadingState
(تعداد)Space.SpaceType
(تعداد)Space.Type
(تعداد)SpaceBatchUpdatedEventData
(رسالة)SpaceEvent
(رسالة)SpaceNotificationSetting
(رسالة)SpaceNotificationSetting.MuteSetting
(تعداد)SpaceNotificationSetting.NotificationSetting
(تعداد)SpaceReadState
(رسالة)SpaceUpdatedEventData
(رسالة)Thread
(رسالة)ThreadReadState
(رسالة)UpdateMembershipRequest
(رسالة)UpdateMessageRequest
(رسالة)UpdateSpaceNotificationSettingRequest
(رسالة)UpdateSpaceReadStateRequest
(رسالة)UpdateSpaceRequest
(رسالة)User
(رسالة)User.Type
(تعداد)UserMentionMetadata
(رسالة)UserMentionMetadata.Type
(تعداد)WidgetMarkup
(رسالة)WidgetMarkup.Button
(رسالة)WidgetMarkup.FormAction
(رسالة)WidgetMarkup.FormAction.ActionParameter
(رسالة)WidgetMarkup.Icon
(تعداد)WidgetMarkup.Image
(رسالة)WidgetMarkup.ImageButton
(رسالة)WidgetMarkup.KeyValue
(رسالة)WidgetMarkup.OnClick
(رسالة)WidgetMarkup.OpenLink
(رسالة)WidgetMarkup.TextButton
(رسالة)WidgetMarkup.TextParagraph
(رسالة)
ChatService
تتيح للمطوّرين إنشاء تطبيقات Chat وعمليات الدمج على Google Chat Platform.
CompleteImportSpace |
---|
تُكمِل هذه العملية عملية الاستيراد للمساحة المحدّدة وتجعلها مرئية للمستخدمين. يتطلّب مصادقة التطبيق والتفويض على مستوى النطاق. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Google Chat لاستيراد البيانات.
|
CreateCustomEmoji |
---|
يتطلب مصادقة المستخدم.
|
CreateMembership |
---|
ينشئ اشتراكًا لتطبيق Chat المخصّص للمكالمات أو مستخدم أو مجموعة على Google. لا تتوفّر إمكانية إنشاء اشتراكات داعمة لتطبيقات Chat الأخرى. عند إنشاء اشتراك، إذا كانت سياسة القبول التلقائي غير مفعّلة لدى العضو المحدّد، يتم دعوته، وعليه قبول دعوة الفضاء قبل الانضمام. بخلاف ذلك، يؤدي إنشاء اشتراك إلى إضافة المستخدم إلى المساحة المحدّدة مباشرةً. تتوافق مع أنواع المصادقة التالية:
لمعرفة أمثلة على الاستخدام، يُرجى الاطّلاع على:
|
CreateMessage |
---|
لإنشاء رسالة في مساحة Google Chat للاطّلاع على مثال، يُرجى الاطّلاع على إرسال رسالة. تتطلّب طريقة توضِّح الصورة التالية كيفية تحديد Chat لمصدر رسالة عند استخدام مصادقة التطبيق. يعرض تطبيق Chat تطبيق Chat كمُرسِل الرسالة. يمكن أن يتضمّن محتوى الرسالة نصًا ( توضِّح الصورة التالية كيفية تحديد Chat لمصدر رسالة عند استخدام مصادقة المستخدم. يعرض Chat المستخدم كمُرسِل الرسالة وينسب تطبيق Chat إلى الرسالة من خلال عرض اسمه. يمكن أن يحتوي محتوى الرسالة على نص فقط ( الحد الأقصى لحجم الرسالة، بما في ذلك محتوى الرسالة، هو 32,000 بايت.
|
CreateReaction |
---|
لإنشاء تفاعل وإضافته إلى رسالة لا يمكن استخدام رموز الإيموجي غير يونيكود. على سبيل المثال، اطّلِع على إضافة تفاعل إلى رسالة. يتطلب مصادقة المستخدم.
|
CreateSpace |
---|
لإنشاء مساحة يمكن استخدامها لإنشاء مساحة مُسمّاة أو محادثة جماعية في تتوافق مع أنواع المصادقة التالية: عند المصادقة كتطبيق، يجب ضبط حقل يعتمد اشتراك المساحة عند إنشائها على ما إذا تم إنشاء المساحة في
إذا ظهرت لك رسالة الخطأ
|
DeleteCustomEmoji |
---|
يتطلب مصادقة المستخدم.
|
DeleteMembership |
---|
حذف اشتراك على سبيل المثال، يمكنك الاطّلاع على إزالة مستخدم أو تطبيق Google Chat من مساحة. تتوافق مع أنواع المصادقة التالية:
|
DeleteMessage |
---|
لحذف رسالة على سبيل المثال، راجِع حذف رسالة. تتوافق مع أنواع المصادقة التالية: عند استخدام مصادقة التطبيق، لا يمكن للطلبات حذف سوى الرسائل التي أنشأها تطبيق Chat المتصل.
|
DeleteReaction |
---|
لحذف تفاعل مع رسالة لا يمكن استخدام رموز الإيموجي غير يونيكود. للحصول على مثال، يُرجى الاطّلاع على حذف تفاعل. يتطلب مصادقة المستخدم.
|
DeleteSpace |
---|
لحذف مساحة مُعنوَنة تُجري هذه العملية دائمًا عملية حذف متسلسلة، ما يعني أنّه يتم أيضًا حذف الموارد الفرعية للمساحة، مثل الرسائل المنشورة في المساحة وعضويات المساحة. على سبيل المثال، يمكنك الاطّلاع على حذف مساحة. تتوافق مع أنواع المصادقة التالية:
|
FindDirectMessage |
---|
عرض الرسالة المباشرة الحالية مع المستخدم المحدّد في حال عدم العثور على مساحة رسالة مباشرة، يتم عرض خطأ باستخدام مصادقة التطبيق، يتم عرض مساحة الرسالة المباشرة بين المستخدم المحدّد وتطبيق Chat المتصل. مع مصادقة المستخدم، يتم عرض مساحة الرسالة المباشرة بين المستخدم المحدّد والمستخدم الذي تمّت المصادقة عليه. // يتيح الأنواع التالية من المصادقة:
|
GetAttachment |
---|
تحصل هذه الطريقة على البيانات الوصفية لمرفق الرسالة. يتم جلب بيانات المرفق باستخدام media API. للاطّلاع على مثال، راجِع مقالة الحصول على البيانات الوصفية حول مرفق رسالة. يتطلب مصادقة التطبيق.
|
GetCustomEmoji |
---|
يتطلب مصادقة المستخدم.
|
GetMembership |
---|
عرض تفاصيل حول اشتراك على سبيل المثال، يُرجى الاطّلاع على الحصول على تفاصيل حول اشتراك مستخدم أو تطبيق Google Chat. تتوافق مع أنواع المصادقة التالية:
|
GetMessage |
---|
عرض تفاصيل عن رسالة على سبيل المثال، يمكنك الاطّلاع على الحصول على تفاصيل عن رسالة. تتوافق مع أنواع المصادقة التالية: ملاحظة: قد يتم عرض رسالة من عضو أو مساحة محظورَين.
|
GetSpace |
---|
عرض تفاصيل عن مساحة على سبيل المثال، يُرجى الاطّلاع على الحصول على تفاصيل عن مساحة. تتوافق مع أنواع المصادقة التالية:
|
GetSpaceEvent |
---|
عرض حدث من مساحة Google Chat تحتوي حمولة الحدث على أحدث إصدار من المرجع الذي تغيّر. على سبيل المثال، إذا طلبت حدثًا بشأن رسالة جديدة ولكن تم تعديل الرسالة لاحقًا، يعرض الخادم مورد ملاحظة: لا يتم عرض الحقل يتطلب مصادقة المستخدم. للحصول على حدث، يجب أن يكون المستخدم الذي تمّت مصادقته عضوًا في المساحة. على سبيل المثال، راجِع مقالة الحصول على تفاصيل عن حدث من مساحة في Google Chat.
|
GetSpaceNotificationSetting |
---|
يتطلب مصادقة المستخدم.
|
GetSpaceReadState |
---|
تعرِض هذه السمة تفاصيل عن حالة قراءة المستخدم ضمن مساحة معيّنة، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة. على سبيل المثال، يمكنك الاطّلاع على الحصول على تفاصيل عن حالة قراءة مساحة المستخدم. يتطلب مصادقة المستخدم.
|
GetThreadReadState |
---|
عرض تفاصيل عن حالة قراءة المستخدم ضمن سلسلة محادثات، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة على سبيل المثال، يمكنك الاطّلاع على الحصول على تفاصيل عن حالة قراءة سلسلة محادثات أحد المستخدمين. يتطلب مصادقة المستخدم.
|
ListCustomEmojis |
---|
يتطلب مصادقة المستخدم.
|
ListMemberships |
---|
تعرض العضويات في مساحة. على سبيل المثال، اطّلِع على إدراج المستخدمين وتطبيقات Google Chat في مساحة. يؤدي إدراج الاشتراكات باستخدام مصادقة التطبيق إلى إدراج الاشتراكات في المساحات التي يمكن لتطبيق Chat الوصول إليها، ولكنّه يستثني الاشتراكات في تطبيق Chat، بما في ذلك الاشتراك الخاص به. يؤدي إدراج العضويات باستخدام مصادقة المستخدم إلى إدراج العضويات في المساحات التي يمكن للمستخدم المُعتمَد الوصول إليها. تتوافق مع أنواع المصادقة التالية:
|
ListMessages |
---|
يعرض هذا الخيار الرسائل في مساحة يكون المتصل عضوًا فيها، بما في ذلك الرسائل الواردة من الأعضاء والمساحات المحظورة. إذا أدرجت رسائل من مساحة لا تحتوي على رسائل، سيكون الردّ عنصرًا فارغًا. عند استخدام واجهة REST/HTTP، يحتوي الردّ على عنصر JSON فارغ، يتطلب مصادقة المستخدم.
|
ListReactions |
---|
يسرد التفاعلات مع رسالة. للحصول على مثال، يُرجى الاطّلاع على عرض قائمة بالتفاعلات مع رسالة. يتطلب مصادقة المستخدم.
|
ListSpaceEvents |
---|
يسرد الأحداث من مساحة Google Chat. يحتوي الحِمل على أحدث إصدار من مورد Chat لكل حدث. على سبيل المثال، إذا أدرجت أحداثًا عن أعضاء جدد في المساحة، يعرض الخادم يتطلب مصادقة المستخدم. لتضمين الأحداث، يجب أن يكون المستخدم الذي تمّت مصادقة هويته عضوًا في المساحة. على سبيل المثال، اطّلِع على إدراج الأحداث من مساحة في Google Chat.
|
ListSpaces |
---|
تعرض هذه السمة المساحات التي يكون المتصل عضوًا فيها. لا يتم إدراج المحادثات الجماعية والرسائل المباشرة إلى أن يتم إرسال أول رسالة. على سبيل المثال، اطّلِع على قائمة المساحات. تتوافق مع أنواع المصادقة التالية: لعرض جميع المساحات المُسمّاة حسب مؤسسة Google Workspace، استخدِم طريقة
|
SearchSpaces |
---|
تعرِض هذه الدالة قائمة بالمساحات في مؤسسة Google Workspace استنادًا إلى بحث المشرف. تتطلب مصادقة المستخدمين الذين لديهم امتيازات المشرف. في الطلب، اضبط
|
SetUpSpace |
---|
لإنشاء مساحة وإضافة مستخدمين محدّدين إليها تتم إضافة المستخدم المتصل تلقائيًا إلى المساحة، ويجب عدم تحديده كعضوية في الطلب. على سبيل المثال، يُرجى الاطّلاع على إعداد مساحة تتضمّن أعضاءً أوليين. لتحديد المستخدمين المطلوب إضافتهم، أضِف العضويات باستخدام لتحديد مجموعات Google المطلوب إضافتها، أضِف العضويات باستخدام الرمز بالنسبة إلى مساحة مُسمّاة أو محادثة جماعية، إذا حظر المتصل بعض الأعضاء أو حظروا المتصل، أو إذا لم يكن لديه الإذن بإضافة بعض الأعضاء، لن تتم إضافة هؤلاء الأعضاء إلى المساحة التي تم إنشاؤها. لإنشاء رسالة مباشرة بين المستخدم المتصل ومستخدم آخر، حدِّد عضوية واحدة بالضبط لتمثيل المستخدم. إذا حظر مستخدم مستخدمًا آخر، سيتعذّر إرسال الطلب ولن يتم إنشاء رسالة خاصة. لإنشاء رسالة مباشرة بين المستخدم المتصل والتطبيق المتصل، اضبط إذا كانت هناك رسالة مباشرة بين مستخدمَين، حتى إذا حظر أحدهما الآخر في وقت تقديم الطلب، سيتم عرض الرسالة المباشرة الحالية. لا تتوفّر المساحات التي تتضمّن ردودًا في سلاسل منفصلة. إذا ظهرت لك رسالة الخطأ يتطلب مصادقة المستخدم.
|
UpdateMembership |
---|
تعديل اشتراك للحصول على مثال، اطّلِع على تعديل عضوية مستخدم في مساحة. تتوافق مع أنواع المصادقة التالية:
|
UpdateMessage |
---|
تعديل رسالة هناك فرق بين الطريقتَين تتوافق مع أنواع المصادقة التالية: عند استخدام مصادقة التطبيق، لا يمكن للطلبات تعديل الرسائل التي أنشأها تطبيق Chat المتصل إلا.
|
UpdateSpace |
---|
تعديل مساحة للحصول على مثال، يُرجى الاطّلاع على تعديل مساحة. إذا كنت بصدد تعديل الحقل تتوافق مع أنواع المصادقة التالية:
|
UpdateSpaceNotificationSetting |
---|
يتطلب مصادقة المستخدم.
|
UpdateSpaceReadState |
---|
تعديل حالة قراءة المستخدم ضمن مساحة، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة على سبيل المثال، راجِع تعديل حالة قراءة مساحة المستخدم. يتطلب مصادقة المستخدم.
|
AccessoryWidget
تطبيق مصغّر تفاعلي واحد أو أكثر يظهر في أسفل الرسالة لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة إضافة تطبيقات مصغّرة تفاعلية في أسفل الرسالة.
الحقول | |
---|---|
حقل الربط action نوع الإجراء. يمكن أن يكون action واحدًا فقط مما يلي: |
|
button_ |
قائمة بالأزرار |
ActionResponse
المَعلمات التي يمكن لتطبيق Chat استخدامها لضبط كيفية نشر ردّه
الحقول | |
---|---|
type |
الإدخال فقط نوع ردّ تطبيق Chat |
url |
الإدخال فقط عنوان URL للمستخدمين للمصادقة أو الضبط (لأنواع الردود من النوع |
dialog_ |
الإدخال فقط ردّ على حدث تفاعل مرتبط بمربّع حوار يجب أن يكون مصحوبًا بـ |
updated_ |
الإدخال فقط استجابة التطبيق المصغّر المعدَّل. |
ResponseType
نوع ردّ تطبيق Chat
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
النوع التلقائي الذي يتم التعامل معه على أنّه NEW_MESSAGE |
NEW_MESSAGE |
انشر الردّ كرسالة جديدة في الموضوع. |
UPDATE_MESSAGE |
عدِّل رسالة تطبيق Chat. لا يُسمح بذلك إلا في حدث CARD_CLICKED حيث يكون نوع مُرسِل الرسالة هو BOT . |
UPDATE_USER_MESSAGE_CARDS |
تعديل البطاقات في رسالة أحد المستخدمين لا يُسمح بذلك إلا كردّ على حدث MESSAGE يتضمّن عنوان URL مطابقًا، أو حدث CARD_CLICKED يكون فيه نوع مُرسِل الرسالة هو HUMAN . يتم تجاهل النص. |
REQUEST_CONFIG |
اطلب من المستخدم بشكل خاص إجراء مصادقة أو ضبط إضافيَين. |
DIALOG |
تعرِض مربّع حوار. |
UPDATE_WIDGET |
طلب بحث خيارات الإكمال التلقائي للنص في التطبيقات المصغّرة |
SelectionItems
قائمة بنتائج الإكمال التلقائي للتطبيقات المصغّرة
الحقول | |
---|---|
items[] |
مصفوفة من عناصر SelectionItem |
UpdatedWidget
استجابة التطبيق المصغّر المعدَّل. يُستخدَم لتوفير خيارات الإكمال التلقائي لأداة مصغّرة.
الحقول | |
---|---|
widget |
رقم تعريف التطبيق المصغّر الذي تم تعديله يجب أن يتطابق رقم التعريف مع رقم تعريف التطبيق المصغّر الذي أدّى إلى تقديم طلب التعديل. |
حقل الربط updated_widget تم تعديل التطبيق المصغّر استجابةً لإجراء من جانب المستخدم. يمكن أن يكون updated_widget واحدًا فقط مما يلي: |
|
suggestions |
قائمة بنتائج الإكمال التلقائي للتطبيقات المصغّرة |
ActionStatus
تمثّل حالة طلب لبدء مربّع حوار أو إرساله.
الحقول | |
---|---|
status_ |
رمز الحالة |
user_ |
الرسالة المُراد إرسالها إلى المستخدمين بشأن حالة طلبهم في حال عدم ضبطه، يتم إرسال رسالة عامة استنادًا إلى |
تعليق توضيحي
النتائج فقط. التعليقات التوضيحية المرتبطة بنص الرسالة العادي لإضافة تنسيق أساسي إلى رسالة نصية، اطّلِع على تنسيق الرسائل النصية.
مثال على نص رسالة عادي:
Hello @FooBot how are you!"
البيانات الوصفية للتعليقات التوضيحية المقابلة:
"annotations":[{
"type":"USER_MENTION",
"startIndex":6,
"length":7,
"userMention": {
"user": {
"name":"users/{user}",
"displayName":"FooBot",
"avatarUrl":"https://goo.gl/aeDtrS",
"type":"BOT"
},
"type":"MENTION"
}
}]
الحقول | |
---|---|
type |
نوع هذا التعليق التوضيحي. |
length |
طول السلسلة الفرعية في نص الرسالة العادي الذي يتوافق معه هذا التعليق التوضيحي. |
start_ |
فهرس البداية (يبدأ من 0 ويشمله) في نص الرسالة العادي الذي يتوافق معه هذا التعليق التوضيحي. |
حقل الربط metadata بيانات وصفية إضافية عن التعليق التوضيحي يمكن أن يكون metadata واحدًا فقط مما يلي: |
|
user_ |
البيانات الوصفية لذكر المستخدم |
slash_ |
البيانات الوصفية لأمر يبدأ بشرطة مائلة |
rich_ |
البيانات الوصفية لرابط تفاعلي |
AnnotationType
نوع التعليق التوضيحي
عمليات التعداد | |
---|---|
ANNOTATION_TYPE_UNSPECIFIED |
القيمة التلقائية للتعداد. لا تستخدِم هذه الميزة. |
USER_MENTION |
ذكر مستخدم |
SLASH_COMMAND |
يتمّ استدعاء أمر يبدأ بشرطة مائلة. |
RICH_LINK |
تعليق توضيحي لرابط تفاعلي |
AttachedGif
صورة GIF محدّدة من خلال عنوان URL
الحقول | |
---|---|
uri |
النتائج فقط. عنوان URL الذي يستضيف صورة GIF |
مرفق
مرفق في Google Chat
الحقول | |
---|---|
name |
اختيارية: اسم مصدر المرفق، بالتنسيق |
content_ |
النتائج فقط. اسم الملف الأصلي للمحتوى، وليس المسار الكامل |
content_ |
النتائج فقط. نوع المحتوى (نوع MIME) للملف |
thumbnail_ |
النتائج فقط. عنوان URL للصورة المصغّرة الذي يجب استخدامه لمعاينة المرفق لمستخدم بشري. يجب ألا تستخدم تطبيقات المحادثات عنوان URL هذا لتنزيل محتوى المرفقات. |
download_ |
النتائج فقط. عنوان URL للتنزيل الذي يجب استخدامه للسماح لأحد المستخدمين بتنزيل المرفق. يجب ألا تستخدم تطبيقات المحادثات عنوان URL هذا لتنزيل محتوى المرفقات. |
source |
النتائج فقط. مصدر المرفق. |
حقل الربط data_ref تشير البيانات إلى المرفق. يمكن أن يكون data_ref واحدًا فقط مما يلي: |
|
attachment_ |
اختيارية: إشارة إلى بيانات المرفق يُستخدَم هذا الحقل لإنشاء رسائل تتضمّن مرفقات أو تعديلها، أو مع media API لتنزيل بيانات المرفقات. |
drive_ |
النتائج فقط. إشارة إلى مرفق Google Drive يُستخدَم هذا الحقل مع واجهة برمجة التطبيقات Google Drive API. |
المصدر
مصدر المرفق.
عمليات التعداد | |
---|---|
SOURCE_UNSPECIFIED |
محجوز. |
DRIVE_FILE |
الملف هو ملف Google Drive. |
UPLOADED_CONTENT |
يتم تحميل الملف إلى Chat. |
AttachmentDataRef
إشارة إلى بيانات المرفق
الحقول | |
---|---|
resource_ |
اختيارية: اسم المورد لبيانات المرفق يُستخدَم هذا الحقل مع واجهة برمجة التطبيقات media API لتنزيل بيانات المرفق. |
attachment_ |
اختيارية: رمز مميز غير شفاف يحتوي على إشارة إلى مرفق تم تحميله. يتعامل العملاء مع هذا العنصر كسلسلة غير شفافة ويستخدمونه لإنشاء رسائل Chat أو تعديلها باستخدام المرفقات. |
CardWithId
بطاقة في رسالة Google Chat
يمكن فقط لتطبيقات Chat إنشاء البطاقات. إذا كان تطبيق Chat يستخدم المصادقة كمستخدم، لا يمكن أن تحتوي الرسالة على بطاقات.
تصميم البطاقات ومعاينتها باستخدام "أداة إنشاء البطاقات"
فتح "أداة إنشاء البطاقات"الحقول | |
---|---|
card_ |
مطلوبة إذا كانت الرسالة تحتوي على عدة بطاقات. معرّف فريد لبطاقة في رسالة |
card |
بطاقة. الحد الأقصى للحجم هو 32 كيلوبايت. |
ChatSpaceLinkData
بيانات روابط مساحات Chat
الحقول | |
---|---|
space |
مساحة مورد مساحة Chat المرتبطة. التنسيق: |
thread |
سلسلة محادثات مورد مساحة Chat المرتبط التنسيق: |
message |
رسالة مورد مساحة Chat المرتبطة. التنسيق: |
CompleteImportSpaceRequest
رسالة طلب لإكمال عملية استيراد مساحة
الحقول | |
---|---|
name |
مطلوب. اسم المورد لمساحة وضع الاستيراد التنسيق: |
CompleteImportSpaceResponse
رسالة ردّ لإكمال عملية الاستيراد لمساحة
الحقول | |
---|---|
space |
مساحة وضع الاستيراد |
ContextualAddOnMarkup
لا يحتوي هذا النوع على أي حقول.
ترميز يتيح للمطوّرين تحديد محتوى الإضافة السياقية
بطاقة
البطاقة هي عنصر واجهة مستخدم يمكن أن يحتوي على تطبيقات مصغّرة لواجهة المستخدم، مثل النصوص والصور.
الحقول | |
---|---|
header |
عنوان البطاقة يحتوي العنوان عادةً على عنوان وصورة. |
sections[] |
يتم فصل الأقسام بفاصل سطر. |
card_ |
إجراءات هذه البطاقة |
name |
اسم البطاقة |
CardAction
إجراء البطاقة هو الإجراء المرتبط بالبطاقة. بالنسبة إلى بطاقة فاتورة، سيكون الإجراء المعتاد هو: حذف الفاتورة أو إرسالها بالبريد الإلكتروني أو فتحها في المتصفّح.
لا تتوفّر هذه الميزة في تطبيقات Google Chat.
الحقول | |
---|---|
action_ |
كان التصنيف يظهر في عنصر قائمة الإجراءات. |
on_ |
إجراء onclick لبنود العمل هذه. |
CardHeader
الحقول | |
---|---|
title |
يجب تحديد العنوان. يكون للعنوان ارتفاع ثابت: إذا تم تحديد عنوان وعنوان فرعي، يشغل كل منهما سطرًا واحدًا. إذا تم تحديد العنوان فقط، سيشغل كلا السطرين. |
subtitle |
العنوان الفرعي لعنوان البطاقة |
image_ |
نوع الصورة (على سبيل المثال، حدود مربّعة أو حدود دائرية) |
image_ |
عنوان URL للصورة في عنوان البطاقة |
ImageStyle
عمليات التعداد | |
---|---|
IMAGE_STYLE_UNSPECIFIED |
|
IMAGE |
حدود مربّعة |
AVATAR |
حدود دائرية |
القسم
يحتوي القسم على مجموعة من التطبيقات المصغّرة التي يتم عرضها (بشكل عمودي) بالترتيب المحدّد. على جميع المنصّات، تكون البطاقات ذات عرض ثابت وضيق، لذا لا حاجة حاليًا إلى سمات التنسيق (مثل float).
الحقول | |
---|---|
header |
عنوان القسم يتوفّر النص المنسَّق. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
widgets[] |
يجب أن يحتوي القسم على تطبيق مصغّر واحد على الأقل. |
CreateCustomEmojiRequest
طلب لإنشاء رمز تعبيري مخصّص
الحقول | |
---|---|
custom_ |
مطلوب. الرمز التعبيري المخصّص المطلوب إنشاؤه |
CreateMembershipRequest
رسالة طلب لإنشاء اشتراك
الحقول | |
---|---|
parent |
مطلوب. اسم المورد للمساحة التي تريد إنشاء الاشتراك لها. التنسيق: spaces/{space} |
membership |
مطلوب. علاقة الاشتراك المطلوب إنشاؤها. يجب أن يحتوي الحقل عندما ينشئ تطبيق Chat علاقة عضوية لمستخدم بشري، يجب أن يستخدم نطاقات تفويض معيّنة ويضبط قيمًا معيّنة لحقول معيّنة:
تتطلّب دعوة مستخدمين من خارج مؤسسة Workspace التي تملك المساحة مصادقة المستخدم. عندما ينشئ تطبيق Chat علاقة عضوية لنفسه، يجب أن يُثبِت هويته كمستخدم ويستخدم نطاق |
use_ |
اختيارية: عند يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". تتطلّب هذه الوظيفة لا يمكن إنشاء اشتراكات في التطبيقات أو إنشاء اشتراكات للمستخدمين خارج مؤسسة المشرف على Google Workspace باستخدام إذن وصول المشرف. |
CreateMessageRequest
لإنشاء رسالة
الحقول | |
---|---|
parent |
مطلوب. اسم المورد للمساحة التي تريد إنشاء رسالة فيها. التنسيق: |
message |
مطلوب. نص الرسالة |
thread_key |
اختيارية: تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام |
request_ |
اختيارية: معرّف طلب فريد لهذه الرسالة يؤدي تحديد رقم تعريف طلب حالي إلى عرض الرسالة التي تم إنشاؤها باستخدام هذا الرقم بدلاً من إنشاء رسالة جديدة. |
message_ |
اختيارية: تُحدِّد ما إذا كانت الرسالة تبدأ سلسلة محادثات أو تردّ على سلسلة محادثات. لا تتوفّر هذه الميزة إلا في المساحات المُسمّاة. عند الردّ على تفاعلات المستخدمين، يتم تجاهل هذا الحقل. بالنسبة إلى التفاعلات ضمن سلسلة محادثات، يتم إنشاء الردّ في سلسلة المحادثات نفسها. بخلاف ذلك، يتم إنشاء الردّ كسلسلة محادثات جديدة. |
message_ |
اختيارية: معرّف مخصّص لرسالة. تتيح تطبيقات Chat الحصول على رسالة أو تعديلها أو حذفها بدون الحاجة إلى تخزين رقم التعريف الذي يحدّده النظام في اسم مورد الرسالة (الممثّل في حقل يجب أن تستوفي قيمة هذا الحقل المتطلبات التالية:
لمعرفة التفاصيل، يُرجى الاطّلاع على تسمية رسالة. |
MessageReplyOption
تُحدِّد كيفية الردّ على رسالة. قد تتم إضافة المزيد من الولايات في المستقبل.
عمليات التعداد | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
تلقائي: بدء سلسلة محادثات جديدة يؤدي استخدام هذا الخيار إلى تجاهل أي thread ID أو مضمّن. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
لإنشاء الرسالة كردّ على سلسلة المحادثات المحدّدة باستخدام thread ID أو . وفي حال تعذّر ذلك، تبدأ الرسالة سلسلة محادثات جديدة بدلاً من ذلك. |
REPLY_MESSAGE_OR_FAIL |
لإنشاء الرسالة كردّ على سلسلة المحادثات المحدّدة باستخدام thread ID أو . في حال استخدام thread_key جديد، يتم إنشاء سلسلة محادثات جديدة. إذا تعذّر إنشاء الرسالة، يتم عرض خطأ NOT_FOUND بدلاً من ذلك. |
CreateReactionRequest
لإنشاء تفاعل مع رسالة
الحقول | |
---|---|
parent |
مطلوب. الرسالة التي تم إنشاء التفاعل عليها التنسيق: |
reaction |
مطلوب. التفاعل الذي يتم إنشاؤه |
CreateSpaceRequest
طلب لإنشاء مساحة مُسمّاة بدون أعضاء
الحقول | |
---|---|
space |
مطلوب. يجب تعبئة حقلَي إذا ظهرت لك رسالة الخطأ يتم تخصيص المساحة |
request_ |
اختيارية: معرّف فريد لهذا الطلب. يُنصح باستخدام معرّف UUID عشوائي. يؤدي تحديد رقم تعريف طلب حالي إلى عرض المساحة التي تم إنشاؤها باستخدام هذا الرقم بدلاً من إنشاء مساحة جديدة. يؤدي تحديد معرّف طلب حالي من تطبيق Chat نفسه باستخدام مستخدم تمّت مصادقته بشكل مختلف إلى ظهور خطأ. |
CustomEmoji
يمثّل رمز إيموجي مخصّصًا.
الحقول | |
---|---|
name |
المعرّف اسم مصدر الرموز التعبيرية المخصّصة الذي حدّده الخادم التنسيق: |
uid |
النتائج فقط. مفتاح فريد لمورد الرموز التعبيرية المخصّصة |
emoji_ |
اختيارية: غير قابل للتغيير اسم يقدّمه المستخدم للرمز التعبيري المخصّص، وهو فريد داخل المؤسسة. مطلوب عند إنشاء الرمز التعبيري المخصّص، وإخراج القيمة فقط في الحالات الأخرى. يجب أن تبدأ أسماء الرموز التعبيرية وتنتهي بنقطتَين، ويجب أن تكون بأحرف صغيرة، ويمكن أن تحتوي فقط على أحرف أبجدية رقمية وواصلات وشرطات سفلية. يجب استخدام الواصلات والشرطات السفلية لفصل الكلمات ولا يمكن استخدامها بشكل متتابع. مثلاً: |
temporary_ |
النتائج فقط. عنوان URL للصورة المخصّصة للرموز التعبيرية، ويجب أن يكون صالحًا لمدة 10 دقائق على الأقل. يُرجى العِلم أنّه لا يتمّ تعبئة هذا الحقل في الردّ عند إنشاء الرمز التعبيري المخصّص. |
payload |
اختيارية: الإدخال فقط بيانات الحمولة مطلوب عند إنشاء الرمز التعبيري المخصّص. |
CustomEmojiPayload
بيانات الحمولة لرمز الإيموجي المخصّص
الحقول | |
---|---|
file_ |
مطلوب. الإدخال فقط الصورة المستخدَمة لرمز الإيموجي المخصّص يجب ألا يزيد حجم الحمولة عن 256 كيلوبايت، ويجب أن تتراوح أبعاد الصورة بين 64 و500 بكسل. تخضع القيود للتغيير. |
filename |
مطلوب. الإدخال فقط اسم ملف الصورة. امتدادات الملفات المتوافقة: |
DeleteCustomEmojiRequest
طلب لحذف رمز تعبيري مخصّص
الحقول | |
---|---|
name |
مطلوب. اسم المورد للرمز التعبيري المخصّص المطلوب حذفه التنسيق: يمكنك استخدام اسم الرمز التعبيري كاسم بديل لـ |
DeleteMembershipRequest
طلب حذف عضوية في مساحة
الحقول | |
---|---|
name |
مطلوب. اسم المورد الخاص بالانضمام المطلوب حذفه يمكن لتطبيقات المحادثة حذف العضويات الخاصة بالمستخدمين أو العضويات الخاصة بها. لا يمكن لتطبيقات المحادثة حذف الاشتراكات في التطبيقات الأخرى. عند حذف اشتراك مستخدم، يجب استخدام النطاق عند حذف اشتراك في تطبيق، يجب استخدام النطاق التنسيق: |
use_ |
اختيارية: عند يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". تتطلّب هذه الوظيفة لا يمكن حذف الاشتراكات في التطبيقات في مساحة باستخدام إذن وصول المشرف. |
DeleteMessageRequest
طلب حذف رسالة
الحقول | |
---|---|
name |
مطلوب. اسم المورد للرسالة التنسيق: إذا كنت قد حدّدت معرّفًا مخصّصًا لرسالتك، يمكنك استخدام القيمة من حقل |
force |
اختيارية: عند لا ينطبق إلا عند المصادقة بصفتك مستخدمًا. لا يؤثّر ذلك في المصادقة كتطبيق Chat. |
DeleteReactionRequest
لحذف تفاعل مع رسالة
الحقول | |
---|---|
name |
مطلوب. اسم التفاعل المطلوب حذفه التنسيق: |
DeleteSpaceRequest
طلب حذف مساحة
الحقول | |
---|---|
name |
مطلوب. اسم المورد للمساحة المطلوب حذفها التنسيق: |
use_ |
اختيارية: عند يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". تتطلّب هذه الوظيفة |
DeletionMetadata
معلومات حول رسالة تم حذفها يتم حذف رسالة عند ضبط delete_time
.
الحقول | |
---|---|
deletion_ |
يشير إلى المستخدم الذي حذف الرسالة. |
DeletionType
المستخدم الذي حذف الرسالة وطريقة حذفها وقد تتم إضافة المزيد من القيم في المستقبل.
عمليات التعداد | |
---|---|
DELETION_TYPE_UNSPECIFIED |
هذه القيمة غير مستخدَمة. |
CREATOR |
حذف المستخدم رسالته. |
SPACE_OWNER |
حذف مالك المساحة الرسالة. |
ADMIN |
حذف مشرف Google Workspace الرسالة. |
APP_MESSAGE_EXPIRY |
حذف تطبيق Chat رسالته عند انتهاء صلاحيتها. |
CREATOR_VIA_APP |
حذف تطبيق Chat الرسالة بالنيابة عن المستخدم. |
SPACE_OWNER_VIA_APP |
حذف تطبيق Chat الرسالة نيابةً عن مالك المساحة. |
مربّع حوار
غلاف حول نص البطاقة في مربّع الحوار
الحقول | |
---|---|
body |
الإدخال فقط نص مربّع الحوار الذي يتم عرضه في نافذة مشروطة لا تتوافق تطبيقات Google Chat مع عناصر البطاقات التالية: |
DialogAction
يحتوي على محادثة ورمز حالة الطلب.
الحقول | |
---|---|
action_ |
الإدخال فقط حالة طلب استدعاء محادثة أو إرسالها تعرِض هذه السمة حالة ورسالة للمستخدمين، إذا لزم الأمر. على سبيل المثال، في حال حدوث خطأ أو نجاح. |
حقل الربط action الإجراء المطلوب تنفيذه يمكن أن يكون action واحدًا فقط مما يلي: |
|
dialog |
الإدخال فقط مربّع الحوار للطلب |
DriveDataRef
إشارة إلى بيانات مرفق في مساحة التخزين
الحقول | |
---|---|
drive_ |
رقم تعريف ملف Drive الاستخدام مع Drive API |
DriveLinkData
بيانات روابط Google Drive
الحقول | |
---|---|
drive_ |
DriveDataRef يشير إلى ملف على Google Drive |
mime_ |
نوع MIME لمورد Google Drive المرتبط. |
رموز الإيموجي
رمز تعبيري يُستخدَم كتفاعل مع رسالة
الحقول | |
---|---|
حقل الربط content مطلوب. محتوى رمز الإيموجي يمكن أن يكون content واحدًا فقط مما يلي: |
|
unicode |
اختيارية: رمز تعبيري أساسي يُمثَّل بسلسلة يونيكود |
custom_ |
النتائج فقط. رمز إيموجي مخصّص |
EmojiReactionSummary
عدد المستخدمين الذين تفاعلوا مع رسالة باستخدام رمز تعبيري معيّن
الحقول | |
---|---|
emoji |
النتائج فقط. الرمز التعبيري المرتبط بالتفاعلات |
reaction_ |
النتائج فقط. إجمالي عدد التفاعلات باستخدام الرمز التعبيري المرتبط |
FindDirectMessageRequest
طلب للحصول على مساحة رسالة مباشرة استنادًا إلى مورد المستخدم
الحقول | |
---|---|
name |
مطلوب. اسم المورد للمستخدم الذي تريد العثور على رسالة مباشرة معه. التنسيق: |
GetAttachmentRequest
اطلب الحصول على مرفق.
الحقول | |
---|---|
name |
مطلوب. اسم مصدر المرفق، بالتنسيق |
GetCustomEmojiRequest
طلب عرض رمز تعبيري مخصّص واحد
الحقول | |
---|---|
name |
مطلوب. اسم المورد للرمز التعبيري المخصّص التنسيق: يمكنك استخدام اسم الرمز التعبيري كاسم بديل لـ |
GetMembershipRequest
طلب الحصول على عضوية في مساحة
الحقول | |
---|---|
name |
مطلوب. اسم المورد الخاص بالانضمام المطلوب استرجاعه للحصول على اشتراك التطبيق باستخدام مصادقة المستخدم، يمكنك اختياريًا استخدام التنسيق: يمكنك استخدام عنوان البريد الإلكتروني للمستخدم كعنوان بديل لـ |
use_ |
اختيارية: عند يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاقات OAuth 2.0 لا يمكن الحصول على اشتراكات في التطبيقات في مساحة عند استخدام إذن وصول المشرف. |
GetMessageRequest
اطلب تلقّي رسالة.
الحقول | |
---|---|
name |
مطلوب. اسم المورد للرسالة التنسيق: إذا كنت قد حدّدت معرّفًا مخصّصًا لرسالتك، يمكنك استخدام القيمة من حقل |
GetSpaceEventRequest
رسالة طلب للحصول على حدث في مساحة
الحقول | |
---|---|
name |
مطلوب. اسم المورد لحدث المساحة التنسيق: |
GetSpaceNotificationSettingRequest
رسالة طلب للحصول على إعدادات الإشعارات في المساحة لا يتيح هذا الخيار سوى ضبط إعدادات الإشعارات للمستخدم المتصل.
الحقول | |
---|---|
name |
مطلوب. التنسيق: users/{user}/spaces/{space}/spaceNotificationSetting
|
GetSpaceReadStateRequest
رسالة طلب واجهة برمجة التطبيقات GetSpaceReadState
الحقول | |
---|---|
name |
مطلوب. اسم المورد لحالة قراءة المساحة المطلوب استرجاعها لا تتيح هذه الوظيفة سوى الحصول على حالة القراءة للمستخدم المتصل. للإشارة إلى المستخدم المتصل، اضبط أحد الخيارَين التاليَين:
التنسيق: users/{user}/spaces/{space}/spaceReadState |
GetSpaceRequest
طلب عرض مسافة واحدة
الحقول | |
---|---|
name |
مطلوب. اسم مورد المساحة، بالتنسيق التنسيق: |
use_ |
اختيارية: عند يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاقات OAuth 2.0 |
GetThreadReadStateRequest
رسالة طلب واجهة برمجة التطبيقات GetThreadReadStateRequest
الحقول | |
---|---|
name |
مطلوب. اسم المورد لحالة قراءة سلسلة المحادثات المطلوب استرجاعها لا تتيح هذه الوظيفة سوى الحصول على حالة القراءة للمستخدم المتصل. للإشارة إلى المستخدم المتصل، اضبط أحد الخيارَين التاليَين:
التنسيق: users/{user}/spaces/{space}/threads/{thread}/threadReadState |
مجموعة
مجموعة Google في Google Chat
الحقول | |
---|---|
name |
اسم المورد لمجموعة Google يمثّل مجموعة في Cloud Identity Groups API. التنسيق: groups/{group} |
HistoryState
حالة السجلّ للرسائل والمساحات تُحدِّد هذه القيمة مدة الاحتفاظ بالرسائل وسلاسل المحادثات بعد إنشائها.
عمليات التعداد | |
---|---|
HISTORY_STATE_UNSPECIFIED |
القيمة التلقائية لا تستخدِم هذه الطريقة. |
HISTORY_OFF |
السجلّ غير مفعَّل. يتم الاحتفاظ بالرسائل وسلاسل المحادثات لمدة 24 ساعة. |
HISTORY_ON |
السجلّ مفعَّل. تحدِّد قواعد الاحتفاظ بالبيانات في Vault الخاصة بالمؤسسة مدة الاحتفاظ بالرسائل سلاسل المحادثات. |
ListCustomEmojisRequest
طلب عرض قائمة برموز الإيموجي المخصّصة
الحقول | |
---|---|
page_ |
اختيارية: الحد الأقصى لعدد رموز الإيموجي المخصّصة التي يتم عرضها يمكن أن تعرض الخدمة عددًا أقل من رموز الإيموجي المخصّصة مقارنةً بهذه القيمة. إذا لم يتم تحديد عدد، تكون القيمة التلقائية هي 25. الحدّ الأقصى للقيمة هو 200، ويتمّ تغيير القيم التي تزيد عن 200 إلى 200. |
page_ |
اختيارية: (في حال استئناف طلب بحث سابق) رمز تعريف صفحة تم تلقّيه من طلب سابق لرمز تعبيري مخصّص لقائمة. قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق قيمة الفلتر مع الطلب الذي قدّم الرمز المميّز للصفحة. قد يؤدي إدخال قيمة مختلفة إلى نتائج غير متوقّعة. |
filter |
اختيارية: فلتر طلب بحث تتيح الفلترة حسب صانع المحتوى. لفلترة المحتوى حسب صانع المحتوى، يجب تحديد قيمة صالحة. لا يتم حاليًا قبول سوى على سبيل المثال، يعرض الطلب التالي رمزًا تعبيريًا مخصّصًا أنشأه المتصل:
يرفض الخادم طلبات البحث غير الصالحة ويعرض خطأ |
ListCustomEmojisResponse
ردّ على قائمة برموز إيموجي مخصّصة
الحقول | |
---|---|
custom_ |
قائمة بدون ترتيب قائمة برموز الإيموجي المخصّصة في الصفحة المطلوبة (أو الأولى) |
next_ |
رمز مميّز يمكنك إرساله على شكل |
ListMembershipsRequest
رسالة طلب إدراج الاشتراكات الداعمة
الحقول | |
---|---|
parent |
مطلوب. اسم المورد للمساحة المطلوب جلب قائمة الاشتراكات فيها. التنسيق: spaces/{space} |
page_ |
اختيارية: الحد الأقصى لعدد الاشتراكات المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد معيّن، يتم عرض 100 اشتراك كحدّ أقصى. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000. تعرِض القيم السلبية خطأ |
page_ |
اختيارية: رمز مميّز للصفحة، تم تلقّيه من طلب سابق لعرض العضويات قدِّم هذه المَعلمة لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة مع الطلب الذي قدّم رمز تعريف الصفحة. قد يؤدي ضبط قيم مختلفة للمَعلمات الأخرى إلى نتائج غير متوقّعة. |
filter |
اختيارية: فلتر طلب بحث يمكنك فلترة الاشتراكات الداعمة حسب دور العضو ( لفلترة البيانات حسب الدور، اضبط للفلترة حسب النوع، اضبط لفلترة البيانات حسب الدور والنوع معًا، استخدِم عامل التشغيل يجب استخدام إما على سبيل المثال، تكون طلبات البحث التالية صالحة:
طلبات البحث التالية غير صالحة:
يرفض الخادم طلبات البحث غير الصالحة ويعرض خطأ |
show_ |
اختيارية: عند |
show_ |
اختيارية: عند تتطلب حاليًا مصادقة المستخدم. |
use_ |
اختيارية: عند يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب هذا الحقل إما لا يمكن إدراج عضويات التطبيقات في مساحة عند استخدام إذن وصول المشرف. |
ListMembershipsResponse
ردّ على قائمة العضويات في المساحة
الحقول | |
---|---|
memberships[] |
قائمة بدون ترتيب قائمة العضويات في الصفحة المطلوبة (أو الأولى) |
next_ |
رمز مميّز يمكنك إرساله على شكل |
ListMessagesRequest
تعرض هذه السمة الرسائل في المساحة المحدّدة التي يكون المستخدم عضوًا فيها.
الحقول | |
---|---|
parent |
مطلوب. اسم المورد للمساحة التي تريد إدراج الرسائل منها التنسيق: |
page_ |
اختيارية: الحد الأقصى لعدد الرسائل المعروضة قد تعرض الخدمة عددًا أقل من الرسائل مقارنةً بهذه القيمة. إذا لم يتم تحديد عدد، يتم عرض 25 عنصرًا بحد أقصى. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000. تعرِض القيم السلبية خطأ |
page_ |
اختيارية: رمز صفحة تم تلقّيه من طلب سابق لرسائل القائمة قدِّم هذه المَعلمة لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة مع الطلب الذي قدّم رمز تعريف الصفحة. قد يؤدي ضبط قيم مختلفة للمَعلمات الأخرى إلى نتائج غير متوقّعة. |
filter |
اختيارية: فلتر طلب بحث يمكنك فلترة الرسائل حسب التاريخ ( لفلترة الرسائل حسب تاريخ إنشائها، حدِّد لفلترة الرسائل حسب سلسلة المحادثات، حدِّد لفلترة النتائج حسب سلسلة المحادثات والتاريخ معًا، استخدِم عامل التشغيل على سبيل المثال، تكون طلبات البحث التالية صالحة:
يرفض الخادم طلبات البحث غير الصالحة ويعرض خطأ |
order_ |
اختيارية: طريقة ترتيب قائمة الرسائل حدِّد قيمة لترتيبها حسب عملية ترتيب. في ما يلي القيم الصالحة لعملية الترتيب:
الترتيب التلقائي هو |
show_ |
اختيارية: ما إذا كنت تريد تضمين الرسائل المحذوفة تتضمّن الرسائل المحذوفة وقت الحذف والبيانات الوصفية حول عملية الحذف، ولكن لا يتوفّر محتوى الرسالة. |
ListMessagesResponse
رسالة الردّ على رسائل إدراج المنتجات.
الحقول | |
---|---|
messages[] |
قائمة الرسائل |
next_ |
يمكنك إرسال رمز مميّز على النحو التالي: |
ListReactionsRequest
يسرد التفاعلات مع رسالة.
الحقول | |
---|---|
parent |
مطلوب. الرسالة التي تفاعل معها المستخدمون التنسيق: |
page_ |
اختيارية: الحد الأقصى لعدد التفاعلات المعروضة يمكن أن تعرض الخدمة عددًا أقل من التفاعلات مقارنةً بهذه القيمة. إذا لم يتم تحديد عدد، تكون القيمة التلقائية هي 25. الحدّ الأقصى للقيمة هو 200، ويتمّ تغيير القيم التي تزيد عن 200 إلى 200. |
page_ |
اختيارية: (في حال استئناف طلب بحث سابق) رمز مميّز للصفحة تم تلقّيه من طلب سابق لعرض التفاعلات مع المحتوى. قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق قيمة الفلتر مع الطلب الذي قدّم الرمز المميّز للصفحة. قد يؤدي إدخال قيمة مختلفة إلى نتائج غير متوقّعة. |
filter |
اختيارية: فلتر طلب بحث يمكنك فلترة التفاعلات حسب الرمز التعبيري ( لفلترة التفاعلات لرموز تعبيرية أو مستخدمين متعدّدين، يمكنك دمج الحقول المتشابهة باستخدام عامل التشغيل لفلترة التفاعلات حسب الرمز التعبيري والمستخدم، استخدِم عامل التشغيل إذا كان طلب البحث يستخدم كلاً من على سبيل المثال، تكون طلبات البحث التالية صالحة:
طلبات البحث التالية غير صالحة:
يرفض الخادم طلبات البحث غير الصالحة ويعرض خطأ |
ListReactionsResponse
ردّ على طلب عرض التفاعلات
الحقول | |
---|---|
reactions[] |
قائمة بالتفاعلات في الصفحة المطلوبة (أو الأولى). |
next_ |
رمز استمرارية لاسترداد الصفحة التالية من النتائج يكون هذا الحقل فارغًا في الصفحة الأخيرة من النتائج. |
ListSpaceEventsRequest
رسالة طلب إدراج أحداث المساحة
الحقول | |
---|---|
parent |
مطلوب. اسم المورد لمساحة Google Chat التي وقعت فيها الأحداث التنسيق: |
page_ |
اختيارية: الحد الأقصى لعدد أحداث المساحة التي يتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. تعرِض القيم السلبية خطأ |
page_ |
اختيارية: رمز تعريف صفحة تم تلقّيه من طلب سابق لأحداث مساحة القائمة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم البيانات إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة لعرض أحداث المساحة مع الطلب الذي قدّم رمز تعريف الصفحة. قد يؤدي ضبط قيم مختلفة للمَعلمات الأخرى إلى نتائج غير متوقّعة. |
filter |
مطلوب. فلتر طلب بحث عليك تحديد نوع حدث واحد على الأقل ( يمكنك أيضًا اختياريًا الفلترة حسب وقت البدء (
لتحديد وقت بدء أو انتهاء، استخدِم عامل التشغيل = على سبيل المثال، تكون طلبات البحث التالية صالحة:
طلبات البحث التالية غير صالحة:
يرفض الخادم طلبات البحث غير الصالحة ويعرض خطأ |
ListSpaceEventsResponse
رسالة الردّ لعرض أحداث المساحة
الحقول | |
---|---|
space_ |
يتم عرض النتائج بترتيب زمني (الحدث الأقدم أولاً). ملاحظة: لا يتم عرض الحقل |
next_ |
رمز المتابعة المستخدَم لجلب المزيد من الأحداث في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة. |
ListSpacesRequest
طلب بعرض المساحات التي يكون المتصل عضوًا فيها
الحقول | |
---|---|
page_ |
اختيارية: الحد الأقصى لعدد المسافات التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، يتم عرض 100 مسافة كحد أقصى. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000. تعرِض القيم السلبية خطأ |
page_ |
اختيارية: رمز تعريف صفحة تم تلقّيه من مكالمة سابقة لطلب قائمة المساحات قدِّم هذه المَعلمة لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق قيمة الفلتر مع الطلب الذي قدّم الرمز المميّز للصفحة. وقد يؤدي إدخال قيمة مختلفة إلى نتائج غير متوقّعة. |
filter |
اختيارية: فلتر طلب بحث يمكنك فلترة المساحات حسب نوع المساحة ( لفلترة البيانات حسب نوع المساحة، عليك تحديد قيمة صحيحة لقائمة القيم المحدّدة مسبقًا، مثل على سبيل المثال، تكون طلبات البحث التالية صالحة:
يرفض الخادم طلبات البحث غير الصالحة ويعرض خطأ |
ListSpacesResponse
ردّ على طلب قائمة المساحات
الحقول | |
---|---|
spaces[] |
قائمة بالمساحات في الصفحة المطلوبة (أو الأولى). ملاحظة: لا يتم عرض الحقل |
next_ |
يمكنك إرسال رمز مميّز على النحو التالي: |
MatchedUrl
عنوان URL مطابق في رسالة Chat يمكن لتطبيقات Chat معاينة عناوين URL المطابقة. لمزيد من المعلومات، يُرجى الاطّلاع على معاينة الروابط.
الحقول | |
---|---|
url |
النتائج فقط. عنوان URL الذي تمت مطابقته |
العضوية
تمثّل علاقة عضوية في Google Chat، مثل ما إذا كان المستخدم أو تطبيق Chat مدعوًا إلى مساحة أو جزءًا منها أو غير متواجد فيها.
الحقول | |
---|---|
name |
المعرّف اسم المورد الخاص بالاشترِك الذي عيّنه الخادم التنسيق: |
state |
النتائج فقط. حالة الاشتراك |
role |
اختيارية: دور المستخدم في مساحة Chat، والذي يحدّد الإجراءات المسموح بها له في المساحة لا يمكن استخدام هذا الحقل إلا كمدخل في |
create_ |
اختيارية: غير قابل للتغيير وقت إنشاء الاشتراك، مثل وقت انضمام عضو إلى مساحة أو دعوته للانضمام إليها هذا الحقل مخصّص للإخراج فقط، باستثناء استخدامه لاستيراد العضويات السابقة في مساحات وضع الاستيراد. |
delete_ |
اختيارية: غير قابل للتغيير وقت حذف العضوية، مثل وقت مغادرة عضو أو إزالته من مساحة هذا الحقل مخصّص للإخراج فقط، باستثناء استخدامه لاستيراد العضويات السابقة في مساحات وضع الاستيراد. |
حقل الربط memberType العضو المرتبط بهذا الاشتراك قد نوفّر أنواع اشتراكات أخرى في المستقبل. يمكن أن يكون memberType واحدًا فقط مما يلي: |
|
member |
اختيارية: المستخدم أو التطبيق في Google Chat الذي يرتبط به الاشتراك. إذا كان تطبيق Chat يستخدم المصادقة كمستخدم، ستتم تعبئة المستخدِم |
group_ |
اختيارية: مجموعة Google التي تتوافق معها العضوية تتطلّب قراءة العضويات في "مجموعات Google" أو تغييرها مصادقة المستخدم. |
MembershipRole
يمثّل الإجراءات المسموح بها للمستخدم في مساحة Chat. قد تتم إضافة المزيد من قيم التعداد في المستقبل.
عمليات التعداد | |
---|---|
MEMBERSHIP_ROLE_UNSPECIFIED |
القيمة التلقائية بالنسبة إلى "users ": ليس هذا المستخدم عضوًا في المساحة، ولكن يمكن دعوته. بالنسبة إلى Google Groups : يتم دائمًا تعيين هذا الدور (قد يتم استخدام قيم أخرى للترقيم في المستقبل). |
ROLE_MEMBER |
عضو في المساحة يحصل المستخدم على أذونات أساسية، مثل إرسال الرسائل إلى المساحة. في المحادثات بين شخصين والمحادثات الجماعية بدون اسم، يحصل الجميع على هذا الدور. |
ROLE_MANAGER |
مدير مساحة يحصل المستخدم على جميع الأذونات الأساسية بالإضافة إلى الأذونات الإدارية التي تتيح له إدارة المساحة، مثل إضافة أعضاء أو إزالتهم. متاح في SpaceType.SPACE فقط. |
MembershipState
تُحدِّد علاقة العضو بالمساحة. قد تتوفّر ولايات أخرى للاشتراك في المستقبل.
عمليات التعداد | |
---|---|
MEMBERSHIP_STATE_UNSPECIFIED |
القيمة التلقائية لا تستخدِم هذه الميزة. |
JOINED |
تتم إضافة المستخدم إلى المساحة، ويمكنه المشاركة فيها. |
INVITED |
تمت دعوة المستخدم للانضمام إلى المساحة، ولكنّه لم ينضم إليها. |
NOT_A_MEMBER |
لا ينتمي المستخدم إلى المساحة وليس لديه دعوة في انتظار المراجعة للانضمام إلى المساحة. |
MembershipBatchCreatedEventData
الحمولة في الحدث لعدة عضويات جديدة
نوع الحدث: google.workspace.chat.membership.v1.batchCreated
الحقول | |
---|---|
memberships[] |
قائمة بالعضويات الجديدة |
MembershipBatchDeletedEventData
الحمولة في الحدث لعدة عضويات تم حذفها
نوع الحدث: google.workspace.chat.membership.v1.batchDeleted
الحقول | |
---|---|
memberships[] |
قائمة بالاشتراكات المحذوفة |
MembershipBatchUpdatedEventData
الحمولة في الحدث لعدة اشتراكات معدَّلة
نوع الحدث: google.workspace.chat.membership.v1.batchUpdated
الحقول | |
---|---|
memberships[] |
قائمة بالاشتراكات المعدّلة |
MembershipCreatedEventData
الحمولة في الحدث لاشتراك جديد.
نوع الحدث: google.workspace.chat.membership.v1.created
.
الحقول | |
---|---|
membership |
العضوية الجديدة |
MembershipDeletedEventData
الحمولة في الحدث لاشتراك تم حذفه
نوع الحدث: google.workspace.chat.membership.v1.deleted
الحقول | |
---|---|
membership |
العضوية المحذوفة. تتم تعبئة الحقلين |
MembershipUpdatedEventData
الحمولة في الحدث لاشتراك معدَّل
نوع الحدث: google.workspace.chat.membership.v1.updated
الحقول | |
---|---|
membership |
العضوية المعدَّلة. |
الرسالة
رسالة في مساحة Google Chat
الحقول | |
---|---|
name |
المعرّف اسم المورد للرسالة التنسيق: حيث يكون في حال ضبط رقم تعريف مخصّص عند إنشاء رسالة، يمكنك استخدام هذا الرقم لتحديد الرسالة في طلب من خلال استبدال |
sender |
النتائج فقط. المستخدم الذي أنشأ الرسالة إذا كان تطبيق Chat يستخدم المصادقة كمستخدم، ستتم تعبئة المستخدِم |
create_ |
اختيارية: غير قابل للتغيير بالنسبة إلى المساحات التي تم إنشاؤها في Chat، يشير ذلك إلى الوقت الذي تم فيه إنشاء الرسالة. هذا الحقل مخصّص للإخراج فقط، باستثناء استخدامه في مساحات وضع الاستيراد. بالنسبة إلى المساحات في وضع الاستيراد، اضبط هذا الحقل على الطابع الزمني السابق الذي تم إنشاء الرسالة فيه في المصدر من أجل الحفاظ على وقت الإنشاء الأصلي. |
last_ |
النتائج فقط. الوقت الذي عدّل فيه أحد المستخدمين الرسالة آخر مرة إذا لم يتم تعديل الرسالة مطلقًا، يكون هذا الحقل فارغًا. |
delete_ |
النتائج فقط. الوقت الذي تم فيه حذف الرسالة في Google Chat إذا لم يتم حذف الرسالة مطلقًا، يكون هذا الحقل فارغًا. |
text |
اختيارية: نص الرسالة بتنسيق نص عادي ينشئ أول رابط يؤدي إلى صورة أو فيديو أو صفحة ويب شريحة معاينة. يمكنك أيضًا الإشارة إلى مستخدم في Google Chat باستخدام@ أو الإشارة إلى جميع المستخدمين في المساحة. للتعرّف على كيفية إنشاء رسائل نصية، يُرجى الاطّلاع على مقالة إرسال رسالة. |
formatted_ |
النتائج فقط. يحتوي على الرسالة
لمزيد من المعلومات، يُرجى الاطّلاع على عرض تنسيق النص المُرسَل في رسالة. |
cards[] |
تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام بطاقات غنية ومنسّقة وتفاعلية يمكنك استخدامها لعرض عناصر واجهة المستخدم، مثل النصوص المنسّقة والأزرار والصور القابلة للنقر يتم عادةً عرض البطاقات أسفل نص الرسالة العادي. يمكن أن يصل حجم |
cards_ |
اختيارية: صفيف من البطاقات يمكن فقط لتطبيقات Chat إنشاء البطاقات. إذا كان تطبيق Chat يستخدم المصادقة كمستخدم، لا يمكن أن تحتوي الرسائل على بطاقات. للتعرّف على كيفية إنشاء رسالة تحتوي على بطاقات، اطّلِع على مقالة إرسال رسالة. تصميم البطاقات ومعاينتها باستخدام "أداة إنشاء البطاقات" فتح "أداة إنشاء البطاقات" |
annotations[] |
النتائج فقط. التعليقات التوضيحية المرتبطة بالرمز |
thread |
سلسلة المحادثات التي تنتمي إليها الرسالة للاطّلاع على أمثلة على الاستخدام، يُرجى الاطّلاع على بدء سلسلة محادثات أو الردّ عليها. |
space |
النتائج فقط. إذا كان تطبيق Chat يُجري مصادقة كمستخدم، ستتم تعبئة المساحة |
fallback_ |
اختيارية: وصف نصي عادي لبطاقات الرسالة، ويُستخدَم عندما لا يمكن عرض البطاقات الفعلية، مثل الإشعارات على الأجهزة الجوّالة. |
action_ |
الإدخال فقط المَعلمات التي يمكن لتطبيق Chat استخدامها لضبط كيفية نشر ردّه |
argument_ |
النتائج فقط. نص الرسالة بتنسيق نص عادي مع إزالة جميع الإشارات إلى تطبيق Chat |
slash_ |
النتائج فقط. معلومات عن الأوامر التي تبدأ بشرطة مائلة، إن وُجدت |
attachment[] |
اختيارية: مرفق حمّله المستخدم |
matched_ |
النتائج فقط. عنوان URL في |
thread_ |
النتائج فقط. عندما يكون إذا كانت المساحة لا تتيح الردّ في سلاسل المحادثات، يكون هذا الحقل دائمًا |
client_ |
اختيارية: معرّف مخصّص للرسالة. يمكنك استخدام الحقل لتحديد رسالة أو الحصول على رسالة أو حذفها أو تعديلها. لضبط رقم تعريف مخصّص، حدِّد حقل |
emoji_ |
النتائج فقط. قائمة بملخصات التفاعلات باستخدام الرموز التعبيرية في الرسالة |
private_ |
اختيارية: غير قابل للتغيير إدخال لإنشاء رسالة، وإلا تكون النتائج فقط. المستخدم الذي يمكنه عرض الرسالة. عند ضبط هذا الخيار، تكون الرسالة خاصة ولا تظهر إلا للمستخدم المحدّد وتطبيق Chat. لتضمين هذا الحقل في طلبك، عليك طلب البيانات من Chat API باستخدام مصادقة التطبيق وحذف ما يلي: لمعرفة التفاصيل، يُرجى الاطّلاع على إرسال رسالة بشكل خاص. |
deletion_ |
النتائج فقط. معلومات حول رسالة تم حذفها يتم حذف رسالة عند ضبط |
quoted_ |
النتائج فقط. معلومات عن رسالة اقتبسها مستخدم Google Chat في مساحة يمكن لمستخدمي Google Chat اقتباس رسالة للرد عليها. |
attached_ |
النتائج فقط. صور GIF المرفقة بالرسالة |
accessory_ |
اختيارية: تطبيق مصغّر تفاعلي واحد أو أكثر يظهر في أسفل الرسالة يمكنك إضافة تطبيقات مصغّرة إضافية إلى الرسائل التي تحتوي على نص أو بطاقات أو كليهما. لا تتوفّر هذه الميزة للرسائل التي تحتوي على مربّعات حوار. لمعرفة التفاصيل، يُرجى الاطّلاع على إضافة تطبيقات مصغّرة تفاعلية في أسفل الرسالة. يتطلب إنشاء رسالة تتضمّن تطبيقات مصغّرة إضافية مصادقة التطبيق. |
MessageBatchCreatedEventData
الحمولة للحدث لعدة رسائل جديدة
نوع الحدث: google.workspace.chat.message.v1.batchCreated
الحقول | |
---|---|
messages[] |
قائمة بالرسائل الجديدة |
MessageBatchDeletedEventData
الحمولة للحدث لعدة رسائل تم حذفها
نوع الحدث: google.workspace.chat.message.v1.batchDeleted
الحقول | |
---|---|
messages[] |
قائمة بالرسائل المحذوفة |
MessageBatchUpdatedEventData
الحمولة للحدث لعدة رسائل معدَّلة
نوع الحدث: google.workspace.chat.message.v1.batchUpdated
الحقول | |
---|---|
messages[] |
قائمة بالرسائل المعدَّلة |
MessageCreatedEventData
الحمولة للحدث لرسالة جديدة.
نوع الحدث: google.workspace.chat.message.v1.created
الحقول | |
---|---|
message |
الرسالة الجديدة |
MessageDeletedEventData
الحمولة لحدث رسالة محذوفة
نوع الحدث: google.workspace.chat.message.v1.deleted
الحقول | |
---|---|
message |
الرسالة المحذوفة يتم ملء حقول |
MessageUpdatedEventData
الحمولة للحدث لرسالة معدَّلة.
نوع الحدث: google.workspace.chat.message.v1.updated
الحقول | |
---|---|
message |
الرسالة المعدَّلة |
QuotedMessageMetadata
معلومات حول رسالة مقتبسة
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد للرسالة المقتبسة التنسيق: |
last_ |
النتائج فقط. الطابع الزمني لوقت إنشاء الرسالة المقتبسة أو وقت آخر تعديل لها |
فيديو يعرض ردود فعل
تفاعل مع رسالة
الحقول | |
---|---|
name |
المعرّف اسم المورد للتفاعل التنسيق: |
user |
النتائج فقط. المستخدم الذي أنشأ التفاعل |
emoji |
مطلوب. الرمز التعبيري المستخدَم في التفاعل |
ReactionBatchCreatedEventData
الحمولة في الحدث لعدة تفاعلات جديدة
نوع الحدث: google.workspace.chat.reaction.v1.batchCreated
الحقول | |
---|---|
reactions[] |
قائمة بالتفاعلات الجديدة |
ReactionBatchDeletedEventData
الحمولة للحدث لعدة تفاعلات محذوفة
نوع الحدث: google.workspace.chat.reaction.v1.batchDeleted
الحقول | |
---|---|
reactions[] |
قائمة بالتفاعلات المحذوفة |
ReactionCreatedEventData
الحمولة في الحدث لتفاعل جديد
نوع الحدث: google.workspace.chat.reaction.v1.created
الحقول | |
---|---|
reaction |
التفاعل الجديد |
ReactionDeletedEventData
الحمولة في الحدث لعملية حذف تفاعُل
النوع: google.workspace.chat.reaction.v1.deleted
الحقول | |
---|---|
reaction |
التفاعل الذي تم حذفه |
RichLinkMetadata
رابط مخصّص يؤدّي إلى مرجع
الحقول | |
---|---|
uri |
معرّف الموارد المنتظم (URI) لهذا الرابط. |
rich_ |
نوع الرابط المزوّد بمحتوى إضافي |
حقل الربط data بيانات المورد المرتبط يمكن أن يكون data واحدًا فقط مما يلي: |
|
drive_ |
بيانات رابط Drive |
chat_ |
بيانات رابط مساحة Chat |
RichLinkType
نوع الرابط المزوّد بمحتوى وقد تتم إضافة المزيد من الأنواع في المستقبل.
عمليات التعداد | |
---|---|
RICH_LINK_TYPE_UNSPECIFIED |
القيمة التلقائية للتعداد. لا تستخدِم هذه الميزة. |
DRIVE_FILE |
نوع رابط منسّق في Google Drive |
CHAT_SPACE |
نوع رابط غني في مساحة Chat على سبيل المثال، شريحة ذكية لمكان |
SearchSpacesRequest
طلب البحث عن قائمة بالمساحات استنادًا إلى طلب بحث
الحقول | |
---|---|
use_ |
عند يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب هذا الحقل إما لا تتيح هذه الطريقة حاليًا سوى إذن وصول المشرف، وبالتالي لا يتم قبول سوى |
page_ |
الحد الأقصى لعدد المسافات التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد المسافات، يتم عرض 100 مسافة كحد أقصى. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000. |
page_ |
رمز مميّز تم استلامه من طلب مساحات البحث السابق قدِّم هذه المَعلمة لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة مع الطلب الذي قدّم رمز تعريف الصفحة. قد يؤدي ضبط قيم مختلفة للمَعلمات الأخرى إلى نتائج غير متوقّعة. |
query |
مطلوب. طلب بحث يمكنك البحث باستخدام المَعلمات التالية:
تقبل السمتَان يجب إدخال لا يقبل يقبل لا يقبل المتغيّر في الحقول المختلفة، لا يُسمَح إلا باستخدام عوامل التشغيل لا يتوافق عامل التشغيل طلبات البحث التالية صالحة:
|
order_ |
اختيارية: كيفية ترتيب قائمة المساحات في ما يلي السمات المتوافقة للترتيب حسبها:
في ما يلي القيم الصالحة لعملية الترتيب:
في ما يلي بنية الجملة المتوافقة:
|
SearchSpacesResponse
ردّ يتضمّن قائمة بالمساحات التي تتوافق مع طلب مساحات البحث
الحقول | |
---|---|
spaces[] |
صفحة للمساحات المطلوبة |
next_ |
رمز مميّز يمكن استخدامه لاسترداد الصفحة التالية. إذا كان هذا الحقل فارغًا، يعني ذلك أنّه ما مِن صفحات لاحقة. |
total_ |
إجمالي عدد المساحات التي تتطابق مع طلب البحث في جميع الصفحات إذا كانت النتيجة أكثر من 10,000 مساحة، تكون هذه القيمة تقديرية. |
SetUpSpaceRequest
طلب إنشاء مساحة وإضافة مستخدمين محدّدين إليها
الحقول | |
---|---|
space |
مطلوب. حقل لإنشاء مساحة، اضبط لإنشاء محادثة جماعية، اضبط لإنشاء محادثة بين شخصين، اضبط لإنشاء محادثة بين شخص وتطبيق Chat، اضبط إذا كانت مساحة |
request_ |
اختيارية: معرّف فريد لهذا الطلب. يُنصح باستخدام معرّف UUID عشوائي. يؤدي تحديد رقم تعريف طلب حالي إلى عرض المساحة التي تم إنشاؤها باستخدام هذا الرقم بدلاً من إنشاء مساحة جديدة. يؤدي تحديد معرّف طلب حالي من تطبيق Chat نفسه باستخدام مستخدم تمّت مصادقته بشكل مختلف إلى ظهور خطأ. |
memberships[] |
اختيارية: مستخدمو Google Chat أو المجموعات المطلوب دعوتها للانضمام إلى المساحة حذف المستخدم المتصل، لأنّه تتم إضافته تلقائيًا تتيح المجموعة حاليًا ما يصل إلى 20 اشتراكًا داعمًا (بالإضافة إلى المتصل). بالنسبة إلى الاشتراكات البشرية، يجب أن يحتوي الحقل بالنسبة إلى اشتراكات مجموعات Google، يجب أن يحتوي الحقل اختيارية عند ضبط مطلوب عند ضبط مطلوب عند ضبط يجب أن تكون فارغة عند إنشاء محادثة بين شخص وتطبيق Chat (عند ضبط |
SlashCommand
أمر يبدأ بشرطة مائلة في Google Chat
الحقول | |
---|---|
command_ |
رقم تعريف الأمر الذي يتضمّن الشرطة المائلة والذي تمّ استدعاؤه. |
SlashCommandMetadata
البيانات الوصفية للتعليق التوضيحي للأوامر التي تبدأ بشرطة مائلة (/)
الحقول | |
---|---|
bot |
تطبيق Chat الذي تمّ استدعاء الأمر منه |
type |
نوع الأمر الذي يبدأ بشرطة مائلة |
command_ |
اسم الأمر المزوّد بشرطة الشرطة المائلة الذي تم استدعاؤه |
command_ |
رقم تعريف الأمر الذي يبدأ بشرطة مائلة والذي تمّ استدعاؤه. |
triggers_ |
يشير إلى ما إذا كان الأمر الذي يبدأ بشرطة مائلة مخصّصًا لمربّع حوار. |
النوع
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
القيمة التلقائية للتعداد. لا تستخدِم هذه الميزة. |
ADD |
أضِف تطبيق Chat إلى المساحة. |
INVOKE |
شغِّل الأمر الذي يبدأ بشرطة مائلة في المساحة. |
مسافة
مساحة في Google Chat المساحات هي محادثات بين مستخدمَين أو أكثر أو رسائل بين مستخدم وتطبيق Chat.
الحقول | |
---|---|
name |
المعرّف اسم المورد للمساحة. التنسيق: حيث يمثّل |
type |
النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام |
space_ |
اختيارية: نوع المساحة مطلوب عند إنشاء مساحة أو تعديل نوع المساحة. النتائج فقط للاستخدامات الأخرى |
single_ |
اختيارية: ما إذا كانت المساحة عبارة عن رسالة مباشرة بين تطبيق Chat ومستخدم واحد |
threaded |
النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام |
display_ |
اختيارية: الاسم المعروض للمساحة مطلوب عند إنشاء مساحة بقيمة بالنسبة إلى الرسائل المباشرة، قد يكون هذا الحقل فارغًا. يمكن أن يتضمّن ما يصل إلى 128 حرفًا. |
external_ |
اختيارية: غير قابل للتغيير ما إذا كانت هذه المساحة تسمح لأي مستخدم في Google Chat بأن يكون عضوًا فيها الإدخال عند إنشاء مساحة في مؤسسة على Google Workspace انسَبِق هذا الحقل عند إنشاء المساحات في الحالات التالية:
بالنسبة إلى المساحات الحالية، يكون هذا الحقل مخصّصًا للعرض فقط. |
space_ |
النتائج فقط. حالة سلسلة المحادثات في مساحة Chat |
space_ |
اختيارية: تفاصيل عن المساحة، بما في ذلك الوصف والقواعد |
space_ |
اختيارية: حالة سجلّ الرسائل للرسائل وسلاسل المحادثات في هذه المساحة |
import_ |
اختيارية: ما إذا تم إنشاء هذه المساحة في يتطلب إنشاء مساحة في |
create_ |
اختيارية: غير قابل للتغيير بالنسبة إلى المساحات التي تم إنشاؤها في Chat، يشير ذلك إلى وقت إنشاء المساحة. هذا الحقل مخصّص للإخراج فقط، باستثناء استخدامه في مساحات وضع الاستيراد. بالنسبة إلى المساحات في وضع الاستيراد، اضبط هذا الحقل على الطابع الزمني السابق الذي تم إنشاء المساحة به في المصدر للحفاظ على وقت الإنشاء الأصلي. لا تتم تعبئة هذا الحقل في الإخراج إلا عندما يكون |
last_ |
النتائج فقط. الطابع الزمني لآخر رسالة في المساحة |
admin_ |
النتائج فقط. بالنسبة إلى مساحات الرسائل المباشرة التي تتضمّن تطبيق Chat، سواء أنشأها مشرف Google Workspace أم لا يمكن للمشرفين تثبيت رسالة مباشرة وإعدادها باستخدام تطبيق Chat نيابةً عن المستخدمين في مؤسستهم. لتفعيل ميزة "التثبيت من خلال المشرف"، يجب أن يتضمّن تطبيق Chat ميزة المراسلة المباشرة. |
membership_ |
النتائج فقط. عدد العضويات التي تم الانضمام إليها مجمّعة حسب نوع العضو تتم تعبئة هذه السمة عندما يكون |
access_ |
اختيارية: تُحدِّد إعداد الوصول إلى المساحة. لا تتم تعبئة هذا الحقل إلا عندما يكون |
space_ |
النتائج فقط. معرّف الموارد المتسلسل (URI) للمستخدم للوصول إلى المساحة |
import_ |
النتائج فقط. الوقت الذي سيحذف فيه النظام المساحة تلقائيًا إذا ظلت في وضع الاستيراد يجب أن تخرج كل مساحة تم إنشاؤها في وضع الاستيراد من هذا الوضع قبل انتهاء صلاحيته باستخدام لا تتم تعبئة هذا الحقل إلا للمساحات التي تم إنشاؤها باستخدام وضع الاستيراد. |
customer |
اختيارية: غير قابل للتغيير رقم تعريف العميل لنطاق المساحة. لا يكون مطلوبًا إلا عند إنشاء مساحة باستخدام مصادقة التطبيق ويكون بالتنسيق لا تتم تعبئة هذا الحقل للرسائل المباشرة. |
حقل الربط يتطلب مصادقة المستخدم. يمكن أن يكون |
|
predefined_ |
اختيارية: الإدخال فقط إعدادات أذونات المساحة المحدَّدة مسبقًا، لا يتم إدخالها إلا عند إنشاء مساحة. في حال عدم ضبط الحقل، يتم إنشاء مساحة تعاون. بعد إنشاء المساحة، تتم تعبئة الإعدادات في الحقل |
permission_ |
اختيارية: إعدادات أذونات المساحة للمساحات الحالية إدخال لتعديل إعدادات أذونات المساحة الدقيقة، حيث يتم استبدال إعدادات الأذونات الحالية يسرد الإخراج إعدادات الأذونات الحالية. |
AccessSettings
يمثّل إعداد الوصول للمساحة.
الحقول | |
---|---|
access_ |
النتائج فقط. يشير إلى حالة الوصول إلى المساحة. |
audience |
اختيارية: اسم المرجع للجمهور المستهدَف الذي يمكنه اكتشاف المساحة والانضمام إليها ومعاينة الرسائل فيها. في حال عدم ضبط هذا الخيار، لن يتمكّن من الوصول إلى المساحة سوى المستخدمين أو "مجموعات Google" الذين تمت دعوتهم أو إضافتهم إلى المساحة بشكل فردي. لمعرفة التفاصيل، يُرجى الاطّلاع على إتاحة مساحة للاكتشاف من قِبل جمهور مستهدف. التنسيق: لاستخدام الجمهور المستهدَف التلقائي لمؤسّسة Google Workspace، اضبط القيمة على تتيح قراءة الجمهور المستهدَف ما يلي:
لا يتمّ ملء هذا الحقل عند استخدام نطاق يتطلب ضبط الجمهور المستهدَف مصادقة المستخدِم. |
AccessState
يمثّل حالة الوصول إلى المساحة.
عمليات التعداد | |
---|---|
ACCESS_STATE_UNSPECIFIED |
حالة الوصول غير معروفة أو غير متاحة في واجهة برمجة التطبيقات هذه. |
PRIVATE |
لا يمكن إلا للمستخدمين أو مجموعات Google الذين تمت إضافتهم أو دعوتهم بشكل فردي من قِبل مستخدمين آخرين أو مشرفي Google Workspace اكتشاف المساحة والوصول إليها. |
DISCOVERABLE |
منَح مدير المساحة إذن الوصول إلى المساحة لجمهور مستهدف. يمكن أيضًا للمستخدمين أو "مجموعات Google" الذين تمت إضافتهم أو دعوتهم إلى المساحة بشكل فردي العثور عليها والوصول إليها. لمزيد من المعلومات، يُرجى الاطّلاع على إتاحة العثور على مساحة لمستخدمين محدّدين. يتطلّب إنشاء مساحات قابلة للاكتشاف مصادقة المستخدم. |
MembershipCount
يمثّل عدد العضويات في مساحة معيّنة، ويتم تجميعها في فئات.
الحقول | |
---|---|
joined_ |
النتائج فقط. عدد المستخدمين الذين انضموا إلى المساحة مباشرةً، بدون احتساب المستخدمين الذين انضموا من خلال عضوية في مجموعة. |
joined_ |
النتائج فقط. عدد جميع المجموعات التي انضمت إلى المساحة مباشرةً |
PermissionSetting
يمثّل إعداد إذن مساحة.
الحقول | |
---|---|
managers_ |
اختيارية: ما إذا كان لدى مدراء المساحات هذا الإذن |
members_ |
اختيارية: ما إذا كان لدى الأعضاء غير المدراء هذا الإذن |
PermissionSettings
إعدادات الأذونات التي يمكنك تحديدها عند تعديل مساحة حالية مُسمّاة
لضبط إعدادات الأذونات عند إنشاء مساحة، حدِّد حقل PredefinedPermissionSettings
في طلبك.
الحقول | |
---|---|
manage_ |
اختيارية: إعدادات لإدارة الأعضاء والمجموعات في مساحة |
modify_ |
اختيارية: إعدادات لتعديل اسم المساحة وصورتها الرمزية ووصفها وإرشاداتها |
toggle_ |
اختيارية: إعداد لتفعيل سجلّ المساحة وإيقافه |
use_ |
اختيارية: إعدادات استخدام @all في مساحة |
manage_ |
اختيارية: إعدادات إدارة التطبيقات في مساحة |
manage_ |
اختيارية: إعداد لإدارة روابط الردّ التلقائي على الويب في مساحة |
post_ |
النتائج فقط. إعدادات نشر الرسائل في مساحة |
reply_ |
اختيارية: إعدادات الردّ على الرسائل في مساحة |
PredefinedPermissionSettings
إعدادات الأذونات المحدّدة مسبقًا التي لا يمكنك تحديدها إلا عند إنشاء مساحة مُعنوَنة. وقد تتم إضافة المزيد من الإعدادات في المستقبل. للاطّلاع على تفاصيل عن إعدادات الأذونات للمساحات المُسمّاة، يُرجى الاطّلاع على التعرّف على المساحات.
عمليات التعداد | |
---|---|
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED |
غير محدد لا تستخدِم هذه الميزة. |
COLLABORATION_SPACE |
إعداد لجعل المساحة مساحة تعاون يمكن لجميع الأعضاء نشر الرسائل فيها |
ANNOUNCEMENT_SPACE |
إعداد لجعل المساحة مساحة إعلانية يمكن لمدراء المساحة فقط نشر الرسائل فيها |
SpaceDetails
تفاصيل عن المساحة، بما في ذلك الوصف والقواعد
الحقول | |
---|---|
description |
اختيارية: وصف للمساحة على سبيل المثال، يمكنك وصف موضوع المناقشة في المساحة أو الغرض الوظيفي منها أو المشاركين فيها. يمكن استخدام 150 حرفًا كحدّ أقصى. |
guidelines |
اختيارية: قواعد المساحة وتوقعاتها وآدابها يمكن إدخال ما يصل إلى 5,000 حرف. |
SpaceThreadingState
تُحدِّد حالة سلسلة المحادثات في مساحة Chat.
عمليات التعداد | |
---|---|
SPACE_THREADING_STATE_UNSPECIFIED |
محجوز. |
THREADED_MESSAGES |
المساحات المُسمّاة التي تتيح سلاسل الرسائل عندما يردّ المستخدمون على رسالة، يمكنهم الردّ في سلسلة المحادثات، ما يحافظ على ردّهم في سياق الرسالة الأصلية. |
GROUPED_MESSAGES |
مساحات مُسمّاة يتم تنظيم المحادثة فيها حسب الموضوع يتم تجميع المواضيع والردود عليها معًا. |
UNTHREADED_MESSAGES |
الرسائل المباشرة بين شخصَين والمحادثات الجماعية بين 3 أشخاص أو أكثر |
SpaceType
نوع المساحة مطلوب عند إنشاء مساحة أو تعديلها. النتائج فقط للاستخدامات الأخرى
عمليات التعداد | |
---|---|
SPACE_TYPE_UNSPECIFIED |
محجوز. |
SPACE |
مكان يرسل فيه المستخدمون الرسائل ويشاركون الملفات ويتعاونون معًا يمكن أن يتضمّن SPACE تطبيقات Chat. |
GROUP_CHAT |
المحادثات الجماعية بين 3 أشخاص أو أكثر يمكن أن يتضمّن GROUP_CHAT تطبيقات Chat. |
DIRECT_MESSAGE |
الرسائل بين شخصَين أو بين شخص وتطبيق Chat |
النوع
تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام SpaceType
بدلاً منها.
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
محجوز. |
ROOM |
محادثات بين شخصين أو أكثر |
DM |
رسالة مباشرة بين شخص وتطبيق Chat، حيث تكون جميع الرسائل مسطّحة. يُرجى العِلم أنّ ذلك لا يشمل الرسائل المباشرة بين شخصين. |
SpaceBatchUpdatedEventData
الحمولة للحدث لإجراء تعديلات متعدّدة على مساحة
نوع الحدث: google.workspace.chat.space.v1.batchUpdated
الحقول | |
---|---|
spaces[] |
قائمة بالمساحات المعدَّلة |
SpaceEvent
حدث يمثّل تغييرًا أو نشاطًا في مساحة Google Chat لمزيد من المعلومات، راجِع العمل مع الأحداث من Google Chat.
الحقول | |
---|---|
name |
اسم المورد لحدث المساحة التنسيق: |
event_ |
الوقت الذي حدث فيه الحدث |
event_ |
نوع حدث المساحة يحتوي كل نوع من أنواع الأحداث على إصدار مجمّع يمثّل نُسخًا متعددة من نوع الحدث الذي يحدث خلال فترة زمنية قصيرة. بالنسبة إلى طلبات أنواع الأحداث المتوافقة للرسائل:
أنواع الأحداث المتوافقة مع الاشتراكات:
أنواع الأحداث المتوافقة للتفاعلات:
أنواع الأحداث المتوافقة حول المساحة:
|
حقل الربط يمكن أن يكون |
|
message_ |
الحمولة للحدث لرسالة جديدة. نوع الحدث: |
message_ |
الحمولة للحدث لرسالة معدَّلة. نوع الحدث: |
message_ |
الحمولة لحدث رسالة محذوفة نوع الحدث: |
message_ |
الحمولة للحدث لعدة رسائل جديدة نوع الحدث: |
message_ |
الحمولة للحدث لعدة رسائل معدَّلة نوع الحدث: |
message_ |
الحمولة للحدث لعدة رسائل تم حذفها نوع الحدث: |
space_ |
الحمولة البرمجية للحدث لتعديل مساحة نوع الحدث: |
space_ |
الحمولة للحدث لإجراء تعديلات متعدّدة على مساحة نوع الحدث: |
membership_ |
الحمولة في الحدث لاشتراك جديد. نوع الحدث: |
membership_ |
الحمولة في الحدث لاشتراك معدَّل نوع الحدث: |
membership_ |
الحمولة في الحدث لاشتراك تم حذفه نوع الحدث: |
membership_ |
الحمولة في الحدث لعدة عضويات جديدة نوع الحدث: |
membership_ |
الحمولة في الحدث لعدة اشتراكات معدَّلة نوع الحدث: |
membership_ |
الحمولة في الحدث لعدة عضويات تم حذفها نوع الحدث: |
reaction_ |
الحمولة في الحدث لتفاعل جديد نوع الحدث: |
reaction_ |
الحمولة في الحدث لعملية حذف تفاعُل نوع الحدث: |
reaction_ |
الحمولة في الحدث لعدة تفاعلات جديدة نوع الحدث: |
reaction_ |
الحمولة للحدث لعدة تفاعلات محذوفة نوع الحدث: |
SpaceNotificationSetting
إعدادات الإشعارات لمستخدم في مساحة
الحقول | |
---|---|
name |
المعرّف اسم المرجع لإعدادات إشعارات المساحة. التنسيق: |
notification_ |
إعدادات الإشعارات |
mute_ |
إعداد كتم صوت إشعارات المساحة |
MuteSetting
أنواع إعدادات كتم صوت إشعارات المساحة
عمليات التعداد | |
---|---|
MUTE_SETTING_UNSPECIFIED |
محجوز. |
UNMUTED |
سيتلقّى المستخدم إشعارات بشأن المساحة استنادًا إلى إعداد الإشعار. |
MUTED |
لن يتلقّى المستخدم أي إشعارات بشأن المساحة، بغض النظر عن إعدادات الإشعارات. |
NotificationSetting
أنواع إعدادات الإشعارات
عمليات التعداد | |
---|---|
NOTIFICATION_SETTING_UNSPECIFIED |
محجوز. |
ALL |
يتم تلقّي الإشعارات عند الإشارة إليك باستخدام @أو عند إرسال أول رسالة في سلاسل المحادثات الجديدة أو عند إرسال سلاسل محادثات تتم متابعتها. تتم متابعة جميع سلاسل المحادثات الجديدة تلقائيًا، ما لم يلغِ المستخدم متابعتها يدويًا. |
MAIN_CONVERSATIONS |
يتم تشغيل الإشعار من خلال الإشارات باستخدام @وسلاسل المحادثات التي تتم متابعتها والرسالة الأولى من سلاسل المحادثات الجديدة. لا تتوفّر هذه الميزة للرسائل المباشرة بين شخصَين. |
FOR_YOU |
يتم تشغيل الإشعار من خلال الإشارات باستخدام @وسلاسل المحادثات التي تتم متابعتها. لا تتوفّر هذه الميزة للرسائل المباشرة بين شخصَين. |
OFF |
الإشعار غير مفعّل. |
SpaceReadState
حالة قراءة المستخدم ضمن مساحة، تُستخدَم لتحديد الرسائل المقروءة وغير المقروءة.
الحقول | |
---|---|
name |
اسم المورد لحالة قراءة المساحة التنسيق: |
last_ |
اختيارية: الوقت الذي تم فيه تعديل حالة قراءة المستخدم للمساحة ويتوافق ذلك عادةً مع الطابع الزمني لآخر رسالة تمت قراءتها، أو الطابع الزمني الذي حدّده المستخدم لتحديد موضع القراءة الأخير في مساحة. |
SpaceUpdatedEventData
الحمولة للحدث لمساحة معدَّلة
نوع الحدث: google.workspace.chat.space.v1.updated
الحقول | |
---|---|
space |
المساحة المعدَّلة |
Thread
سلسلة محادثات في مساحة Google Chat للاطّلاع على أمثلة على الاستخدام، يُرجى الاطّلاع على بدء سلسلة محادثات أو الردّ عليها.
إذا حدّدت سلسلة محادثات عند إنشاء رسالة، يمكنك ضبط الحقل messageReplyOption
لتحديد ما يحدث في حال عدم العثور على سلسلة محادثات مطابقة.
الحقول | |
---|---|
name |
المعرّف اسم المورد الخاص بالسلسلة مثلاً: |
thread_ |
اختيارية: إدخال لإنشاء سلسلة محادثات أو تعديلها بخلاف ذلك، يتم عرض النتائج فقط. رقم تعريف سلسلة المحادثات يمكن إدخال ما يصل إلى 4,000 حرف. هذا المعرّف فريد لتطبيق Chat الذي يضبطه. على سبيل المثال، إذا أنشأت تطبيقات محادثة متعددة رسالة باستخدام مفتاح سلسلة المحادثات نفسه، يتم نشر الرسائل في سلاسل محادثات مختلفة. للردّ في سلسلة محادثات أنشأها مستخدم أو تطبيق Chat آخر، حدِّد حقل سلسلة المحادثات |
ThreadReadState
حالة قراءة المستخدم ضمن سلسلة محادثات، تُستخدَم لتحديد الرسائل المقروءة وغير المقروءة.
الحقول | |
---|---|
name |
اسم المورد لحالة قراءة سلسلة المحادثات التنسيق: |
last_ |
الوقت الذي تم فيه تعديل حالة قراءة المستخدم للمحادثة يتطابق هذا عادةً مع الطابع الزمني لآخر رسالة تمت قراءتها في سلسلة محادثات. |
UpdateMembershipRequest
رسالة طلب لتعديل اشتراك
الحقول | |
---|---|
membership |
مطلوب. الاشتراك المطلوب تعديله لا يتم تعديل سوى الحقول المحدّدة باستخدام |
update_ |
مطلوب. مسارات الحقول المطلوب تعديلها افصل القيم المتعدّدة بفواصل أو استخدِم مسارات الحقول المتوافقة حاليًا:
|
use_ |
اختيارية: عند يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". تتطلّب هذه الوظيفة |
UpdateMessageRequest
طلب تعديل رسالة
الحقول | |
---|---|
message |
مطلوب. رسالة تم تعديل الحقول فيها |
update_ |
مطلوب. مسارات الحقول التي سيتم تعديلها افصل بين القيم المتعددة بفواصل أو استخدِم مسارات الحقول المتوافقة حاليًا:
|
allow_ |
اختيارية: إذا لم يتم العثور على |
UpdateSpaceNotificationSettingRequest
طلب تعديل إعدادات الإشعارات في المساحة لا تتيح هذه الميزة تعديل إعدادات الإشعارات إلا للمستخدم المتصل.
الحقول | |
---|---|
space_ |
مطلوب. يجب تعبئة اسم المورد لإعدادات إشعارات المساحة على النحو التالي: |
update_ |
مطلوب. مسارات الحقول المتوافقة: - |
UpdateSpaceReadStateRequest
رسالة طلب واجهة برمجة التطبيقات UpdateSpaceReadState
الحقول | |
---|---|
space_ |
مطلوب. حالة قراءة المساحة والحقول التي سيتم تعديلها لا تتيح هذه الميزة تعديل حالة القراءة إلا للمستخدم المتصل. للإشارة إلى المستخدم المتصل، اضبط أحد الخيارَين التاليَين:
التنسيق: users/{user}/spaces/{space}/spaceReadState |
update_ |
مطلوب. مسارات الحقول التي سيتم تعديلها مسارات الحقول المتوافقة حاليًا:
عندما يكون لوضع علامة "تمت القراءة" على المساحة، اضبط |
UpdateSpaceRequest
طلب لتعديل مساحة واحدة
الحقول | |
---|---|
space |
مطلوب. مساحة تحتوي على حقول ستتمّ مراجعتها يجب تعبئة |
update_ |
مطلوب. مسارات الحقول المعدّلة، مفصولة بفواصل في حال توفّر عدة مسارات يمكنك تعديل الحقول التالية للمساحة:
|
use_ |
اختيارية: عند يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". تتطلّب هذه الوظيفة لا تتوفّر بعض قيم |
المستخدم
مستخدم في Google Chat عند عرضها كنتيجة من طلب، إذا كان تطبيق Chat يُثبِّت هويته كمستخدم، لا تملأ نتيجة مورد User
سوى name
وtype
للمستخدم.
الحقول | |
---|---|
name |
اسم المورد لـ التنسيق: بالنسبة إلى
|
display_ |
النتائج فقط. الاسم المعروض للمستخدم. |
domain_ |
المعرّف الفريد لنطاق المستخدم على Google Workspace |
type |
نوع المستخدم |
is_ |
النتائج فقط. عند |
النوع
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
القيمة التلقائية للتعداد. يُرجى عدم استخدامها. |
HUMAN |
مستخدم بشري |
BOT |
مستخدم تطبيق Chat |
UserMentionMetadata
البيانات الوصفية للتعليق التوضيحي لذكر المستخدمين (@)
الحقول | |
---|---|
user |
المستخدم المُشار إليه |
type |
نوع الإشارة إلى المستخدم |
النوع
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
القيمة التلقائية للتعداد لا تستخدِم هذه الميزة. |
ADD |
أضِف المستخدم إلى المساحة. |
MENTION |
الإشارة إلى مستخدم في المساحة |
WidgetMarkup
التطبيق المصغّر هو عنصر واجهة مستخدم يعرض النصوص والصور.
الحقول | |
---|---|
buttons[] |
قائمة بالأزرار Buttons هي أيضًا |
حقل الربط data لا يمكن أن يتضمّن WidgetMarkup سوى أحد العناصر التالية. يمكنك استخدام حقول WidgetMarkup متعددة لعرض المزيد من العناصر. يمكن أن يكون data واحدًا فقط مما يلي: |
|
text_ |
عرض فقرة نصية في هذه الأداة المصغّرة |
image |
عرض صورة في هذه الأداة المصغّرة |
key_ |
عرض عنصر مفتاح/قيمة في هذه الأداة المصغّرة |
زرّ
زر يمكن أن يكون زرًا نصيًا أو زرًا مزوّدًا بصورة.
الحقول | |
---|---|
حقل الربط يمكن أن يكون |
|
text_ |
زر يحتوي على نص وإجراء |
image_ |
زر يتضمّن صورة وإجراء |
FormAction
يصف إجراء النموذج السلوك عند إرسال النموذج. على سبيل المثال، يمكنك استدعاء Apps Script لمعالجة النموذج.
الحقول | |
---|---|
action_ |
يُستخدَم اسم الطريقة لتحديد الجزء من النموذج الذي أدّى إلى إرسال النموذج. تتم إعادة هذه المعلومات إلى تطبيق Chat كجزء من حدث النقر على البطاقة. يمكنك استخدام اسم الطريقة نفسه لعدة عناصر تؤدي إلى سلوك شائع. |
parameters[] |
قائمة بمَعلمات الإجراءات |
ActionParameter
قائمة بمَعلمات السلاسل التي يجب تقديمها عند استدعاء طريقة الإجراء على سبيل المثال، يمكنك استخدام ثلاثة أزرار لتأجيل التنبيه: تأجيل الآن، وتأجيل لمدة يوم واحد، وتأجيل في الأسبوع القادم. يمكنك استخدام action method = snooze()
، مع تمرير نوع الغفوة ووقت الغفوة في قائمة مَعلمات السلاسل.
الحقول | |
---|---|
key |
اسم المَعلمة لنص الإجراء |
value |
قيمة المَعلمة |
الرمز
مجموعة الرموز المتوافقة
عمليات التعداد | |
---|---|
ICON_UNSPECIFIED |
|
AIRPLANE |
|
BOOKMARK |
|
BUS |
|
CAR |
|
CLOCK |
|
CONFIRMATION_NUMBER_ICON |
|
DOLLAR |
|
DESCRIPTION |
|
EMAIL |
|
EVENT_PERFORMER |
|
EVENT_SEAT |
|
FLIGHT_ARRIVAL |
|
FLIGHT_DEPARTURE |
|
HOTEL |
|
HOTEL_ROOM_TYPE |
|
INVITE |
|
MAP_PIN |
|
MEMBERSHIP |
|
MULTIPLE_PEOPLE |
|
OFFER |
|
PERSON |
|
PHONE |
|
RESTAURANT_ICON |
|
SHOPPING_CART |
|
STAR |
|
STORE |
|
TICKET |
|
TRAIN |
|
VIDEO_CAMERA |
|
VIDEO_PLAY |
صورة
صورة يتم تحديدها من خلال عنوان URL ويمكن أن تتضمّن إجراءً من النوع onclick
الحقول | |
---|---|
image_ |
عنوان URL للصورة |
on_ |
إجراء |
aspect_ |
نسبة العرض إلى الارتفاع لهذه الصورة (العرض والارتفاع) يتيح لك هذا الحقل حجز الارتفاع المناسب للصورة أثناء انتظار تحميلها. ولا يهدف إلى إلغاء نسبة العرض إلى الارتفاع المضمّنة في الصورة. في حال عدم ضبطها، يملؤها الخادم من خلال التحميل المُسبَق للصورة. |
ImageButton
زر صورة يتضمّن إجراءً onclick
الحقول | |
---|---|
on_ |
إجراء |
name |
اسم |
حقل الربط icons يمكن تحديد الرمز باستخدام Icon enum أو عنوان URL. يمكن أن يكون icons واحدًا فقط مما يلي: |
|
icon |
الرمز المحدّد بواسطة |
icon_ |
الرمز المحدّد من خلال عنوان URL |
KeyValue
يحتوي عنصر واجهة المستخدم على مفتاح (تصنيف) وقيمة (محتوى). يمكن أن يحتوي هذا العنصر أيضًا على بعض الإجراءات، مثل زر onclick
.
الحقول | |
---|---|
top_ |
نص التصنيف العلوي يتوفّر النص المنسّق. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
content |
نص المحتوى يجب استخدام نص منسّق في كل الأوقات. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
content_ |
إذا كان المحتوى يجب أن يكون متعدّد الأسطر |
bottom_ |
نص التصنيف السفلي يتوفّر النص المنسّق. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace. |
on_ |
إجراء |
حقل الربط icons يجب تحديد رمز واحد على الأقل من الرموز top_label وbottom_label . يمكن أن يكون icons واحدًا فقط مما يلي: |
|
icon |
قيمة مصنّفة تم استبدالها من خلال Chat API بصورة الرمز المعنيّ. |
icon_ |
الرمز المحدّد من خلال عنوان URL |
حقل الربط control تطبيق مصغّر للتحكّم يمكنك ضبط button أو switch_widget ، ولكن ليس كليهما. يمكن أن يكون control واحدًا فقط مما يلي: |
|
button |
زر يمكن النقر عليه لبدء إجراء |
OnClick
إجراء onclick
(مثل فتح رابط)
الحقول | |
---|---|
حقل الربط يمكن أن يكون |
|
action |
يتم بدء إجراء نموذج من خلال إجراء |
open_ |
يؤدي إجراء |
OpenLink
رابط يفتح نافذة جديدة
الحقول | |
---|---|
url |
عنوان URL المطلوب فتحه |
TextButton
زر يحتوي على نص وإجراء onclick
الحقول | |
---|---|
text |
النص المكتوب على الزر. |
on_ |
إجراء |
TextParagraph
فقرة من النص يتوفّر النص المنسّق. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace.
الحقول | |
---|---|
text |
|