Package google.chat.v1

الفهرس

• 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 (رسالة)
• SpaceReadState (رسالة)
• SpaceUpdatedEventData (رسالة)
• Thread (رسالة)
• ThreadReadState (رسالة)
• UpdateMembershipRequest (رسالة)
• UpdateMessageRequest (رسالة)
• 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 الأساسي.

CompleteImportSpace

rpc CompleteImportSpace(CompleteImportSpaceRequest) returns (CompleteImportSpaceResponse) تُكمِل هذه العملية عملية الاستيراد للمساحة المحدّدة وتجعلها مرئية للمستخدمين. تتطلب مصادقة التطبيق والتفويض على مستوى النطاق. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفويض تطبيقات Google Chat لاستيراد البيانات. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/chat.import لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

CreateCustomEmoji
rpc CreateCustomEmoji(CreateCustomEmojiRequest) returns (CustomEmoji) معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها. تنشئ رمزًا تعبيريًا مخصّصًا. يتطلب مصادقة المستخدم. نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/chat.customemojis لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership) ينشئ اشتراكًا لتطبيق Chat المخصّص للمكالمات أو مستخدم أو مجموعة على Google. لا تتوفّر إمكانية إنشاء اشتراكات داعمة لتطبيقات Chat الأخرى. عند إنشاء اشتراك، إذا كانت سياسة القبول التلقائي غير مفعّلة لدى العضو المحدّد، يتمّت دعوته، وعليه قبول دعوة الفضاء قبل الانضمام. بخلاف ذلك، يؤدي إنشاء اشتراك إلى إضافة المستخدم إلى المساحة المحدّدة مباشرةً. توفّر الأنواع التالية من المصادقة: مصادقة التطبيق بعد الحصول على موافقة المشرف في قسم معاينة المطوّر مصادقة المستخدم: يمكنك مصادقة هذه الطريقة وتفويضها باستخدام امتيازات المشرف من خلال ضبط الحقل use_admin_access في الطلب. لمعرفة أمثلة على الاستخدام، يُرجى الاطّلاع على: دعوة مستخدم إلى مساحة أو إضافته دعوة "مجموعة Google" أو إضافتها إلى مساحة إضافة تطبيق Chat إلى مساحة نطاقات التفويض يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

CreateMessage

rpc CreateMessage(CreateMessageRequest) returns (Message) لإنشاء رسالة في مساحة Google Chat للاطّلاع على مثال، يُرجى الاطّلاع على إرسال رسالة. تتطلّب طريقة create() إما مصادقة المستخدم أو مصادقة التطبيق. تُحدِّد Chat هوية مُرسِل الرسالة بشكلٍ مختلف استنادًا إلى نوع المصادقة الذي تستخدمه في طلبك. توضِّح الصورة التالية كيفية تحديد Chat لمصدر رسالة عند استخدام مصادقة التطبيق. يعرض تطبيق Chat تطبيق Chat كمُرسِل الرسالة. يمكن أن يتضمّن محتوى الرسالة نصًا (text) وبطاقات (cardsV2) وتطبيقات مصغّرة لوظائف إضافية (accessoryWidgets). توضِّح الصورة التالية كيفية تحديد Chat لمصدر رسالة عند استخدام مصادقة المستخدم. يعرض Chat المستخدم بصفته مُرسِل الرسالة وينسب تطبيق Chat إلى الرسالة من خلال عرض اسمه. يمكن أن يحتوي محتوى الرسالة فقط على نص (text). الحد الأقصى لحجم الرسالة، بما في ذلك محتوى الرسالة، هو 32,000 بايت. نطاقات التفويض يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.create لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

CreateReaction

rpc CreateReaction(CreateReactionRequest) returns (Reaction) لإنشاء تفاعل وإضافته إلى رسالة يمكن استخدام الرموز التعبيرية بترميز يونيكود فقط. على سبيل المثال، راجِع المقالة إضافة تفاعل إلى رسالة. يتطلب مصادقة المستخدم. نطاقات الأذونات يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.create لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

CreateSpace

rpc CreateSpace(CreateSpaceRequest) returns (Space) يتم إنشاء مساحة بدون أعضاء. يمكن استخدامها لإنشاء مساحة مُعنوَنة. المساحات المجمَّعة حسب المواضيع غير متاحة. على سبيل المثال، اطّلِع على إنشاء مساحة. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS عند إنشاء مساحة، جرِّب استخدام displayName آخر. قد تستخدم مساحة حالية في مؤسسة Google Workspace هذا الاسم المعروض. إذا كنت مشتركًا في برنامج معاينة المطوّرين، يمكنك إنشاء محادثة جماعية في وضع الاستيراد باستخدام spaceType.GROUP_CHAT. تتوافق مع أنواع المصادقة التالية: مصادقة التطبيق بعد الحصول على موافقة المشرف في قسم معاينة المطوّر مصادقة المستخدم عند المصادقة كتطبيق، يجب ضبط حقل space.customer في الطلب. نطاقات التفويض يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.app.spaces.create https://www.googleapis.com/auth/chat.app.spaces https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.create لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

DeleteCustomEmoji
rpc DeleteCustomEmoji(DeleteCustomEmojiRequest) returns (Empty) إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. لحذف رمز تعبيري مخصّص يتطلب مصادقة المستخدم. نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/chat.customemojis لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership) يؤدي هذا الإجراء إلى حذف الاشتراك. على سبيل المثال، راجِع إزالة مستخدم أو تطبيق Google Chat من مساحة. توفّر الأنواع التالية من المصادقة: مصادقة التطبيق بعد الحصول على موافقة المشرف في قسم معاينة المطوّر مصادقة المستخدم: يمكنك مصادقة هذه الطريقة وتفويضها باستخدام امتيازات المشرف من خلال ضبط الحقل use_admin_access في الطلب. نطاقات التفويض يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.app لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

DeleteMessage

rpc DeleteMessage(DeleteMessageRequest) returns (Empty) حذف رسالة على سبيل المثال، راجِع حذف رسالة. تتوافق مع أنواع المصادقة التالية: مصادقة التطبيق مصادقة المستخدم عند استخدام مصادقة التطبيق، لا يمكن للطلبات حذف سوى الرسائل التي أنشأها تطبيق Chat المتصل. نطاقات التفويض يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

DeleteReaction

rpc DeleteReaction(DeleteReactionRequest) returns (Empty) لحذف تفاعل مع رسالة لا يُسمح إلا باستخدام رموز الإيموجي بتنسيق يونيكود. على سبيل المثال، راجِع المقالة حذف تفاعل. يتطلب مصادقة المستخدم. نطاقات الأذونات يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.reactions لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

DeleteSpace

rpc DeleteSpace(DeleteSpaceRequest) returns (Empty) حذف مساحة مُعنوَنة يتم دائمًا إجراء حذف متتالي، ما يعني أنّه يتم أيضًا حذف الموارد الفرعية للمساحة، مثل الرسائل المنشورة في المساحة والاشتراكات فيها. على سبيل المثال، يمكنك الاطّلاع على حذف مساحة. توفّر الأنواع التالية من المصادقة: مصادقة التطبيقات من خلال موافقة المشرف في إصدار المطوّر مصادقة المستخدم يمكنك مصادقة هذه الطريقة وتفويضها من خلال امتيازات المشرف من خلال ضبط الحقل use_admin_access في الطلب. نطاقات الأذونات يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.app.delete https://www.googleapis.com/auth/chat.admin.delete https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.delete لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

FindDirectMessage

rpc FindDirectMessage(FindDirectMessageRequest) returns (Space) تعرِض هذه الدالة الرسالة المباشرة الحالية مع المستخدم المحدّد. إذا لم يتم العثور على مساحة رسائل مباشرة، سيتم عرض خطأ 404 NOT_FOUND. على سبيل المثال، راجِع البحث عن رسالة مباشرة. باستخدام مصادقة التطبيق، يتم عرض مساحة الرسالة المباشرة بين المستخدم المحدّد وتطبيق Chat المتصل. مع مصادقة المستخدم، يتم عرض مساحة الرسالة المباشرة بين المستخدم المحدّد والمستخدم الذي تمّت المصادقة عليه. // يتيح الأنواع التالية من المصادقة: مصادقة التطبيق مصادقة المستخدم نطاقات التفويض يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.bot لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

GetAttachment
rpc GetAttachment(GetAttachmentRequest) returns (Attachment) الحصول على البيانات الوصفية لمرفق رسالة يتم استرجاع بيانات المرفقات باستخدام media API. للحصول على مثال، يُرجى الاطّلاع على الحصول على البيانات الوصفية حول مرفق رسالة. يتطلب مصادقة التطبيق. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/chat.bot لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

GetCustomEmoji
rpc GetCustomEmoji(GetCustomEmojiRequest) returns (CustomEmoji) معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها. عرض تفاصيل حول رمز تعبيري مخصّص يتطلب مصادقة المستخدم. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/chat.customemojis لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership) عرض تفاصيل حول اشتراك على سبيل المثال، اطّلِع على الحصول على تفاصيل حول اشتراك مستخدم أو تطبيق Google Chat. توفّر الأنواع التالية من المصادقة: مصادقة التطبيق مصادقة المستخدم: يمكنك مصادقة هذه الطريقة وتفويضها باستخدام امتيازات المشرف من خلال ضبط الحقل use_admin_access في الطلب. نطاقات الأذونات يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

GetMessage

rpc GetMessage(GetMessageRequest) returns (Message) عرض تفاصيل حول رسالة مثلاً، راجِع الحصول على تفاصيل حول رسالة. تتوافق مع أنواع المصادقة التالية: مصادقة التطبيق مصادقة المستخدم ملاحظة: قد يتم عرض رسالة من عضو أو مساحة محظورَين. نطاقات التفويض يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

GetSpace

rpc GetSpace(GetSpaceRequest) returns (Space) عرض تفاصيل عن مساحة على سبيل المثال، يُرجى الاطّلاع على الحصول على تفاصيل عن مساحة. تتوافق مع أنواع المصادقة التالية: مصادقة التطبيق مصادقة المستخدم يمكنك مصادقة هذه الطريقة وتفويضها من خلال امتيازات المشرف من خلال ضبط الحقل use_admin_access في الطلب. نطاقات التفويض يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.admin.spaces.readonly https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.app.spaces لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

GetSpaceEvent

rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent) عرض حدث من مساحة Google Chat تحتوي حمولة الحدث على أحدث إصدار من المورد الذي تم تغييره. على سبيل المثال، إذا طلبت حدثًا بشأن رسالة جديدة ولكن تم تعديل الرسالة لاحقًا، يعرض الخادم مورد Message المعدَّل في حمولة الحدث. ملاحظة: لا يتم عرض الحقل permissionSettings في عنصر المساحة الخاص ببيانات حدث المساحة لهذا الطلب. يتطلب مصادقة المستخدم. للحصول على حدث، يجب أن يكون المستخدم الذي تمّت مصادقة هويته عضوًا في المساحة. على سبيل المثال، راجِع مقالة الحصول على تفاصيل عن حدث من مساحة في Google Chat. نطاقات الأذونات يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.readonly لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

GetSpaceReadState

rpc GetSpaceReadState(GetSpaceReadStateRequest) returns (SpaceReadState) تعرِض هذه السمة تفاصيل عن حالة قراءة المستخدم ضمن مساحة معيّنة، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة. على سبيل المثال، يمكنك الاطّلاع على الحصول على تفاصيل حول حالة قراءة مساحة المستخدم. يتطلب مصادقة المستخدم. نطاقات التفويض يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.users.readstate https://www.googleapis.com/auth/chat.users.readstate.readonly لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

GetThreadReadState

rpc GetThreadReadState(GetThreadReadStateRequest) returns (ThreadReadState) تعرض تفاصيل حول حالة قراءة المستخدم في سلسلة محادثات، وتُستخدم لتحديد الرسائل المقروءة وغير المقروءة. على سبيل المثال، يمكنك الاطّلاع على الحصول على تفاصيل حول حالة قراءة سلسلة محادثات للمستخدم. يتطلب مصادقة المستخدم. نطاقات التفويض يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.users.readstate https://www.googleapis.com/auth/chat.users.readstate.readonly لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

ListCustomEmojis

rpc ListCustomEmojis(ListCustomEmojisRequest) returns (ListCustomEmojisResponse) معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها. يتم إدراج الرموز التعبيرية المخصصة المرئية للمستخدم الذي تمت مصادقته. يتطلب مصادقة المستخدم. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/chat.customemojis لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse) يسرد العضوية في مساحة. على سبيل المثال، اطّلِع على إدراج المستخدمين وتطبيقات Google Chat في مساحة. تعرض بطاقة بيانات المتجر التي تستخدم ميزة المصادقة على التطبيق الاشتراكات في المساحات التي يمكن لتطبيق Chat الوصول إليها، ولكنها تُستثنى منها الاشتراكات في التطبيقات، بما فيها المساحات الخاصة بها. يؤدي إدراج العضويات باستخدام مصادقة المستخدم إلى إدراج العضويات في المساحات التي يمكن للمستخدم المُعتمَد الوصول إليها. تتوافق مع أنواع المصادقة التالية: مصادقة التطبيق مصادقة المستخدم يمكنك مصادقة هذه الطريقة وتفويضها من خلال امتيازات المشرف من خلال ضبط الحقل use_admin_access في الطلب. نطاقات التفويض يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.admin.memberships.readonly https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

ListMessages

rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse) يسرد الرسائل في مساحة يكون المتصل عضوًا فيها، بما في ذلك الرسائل من الأعضاء المحظورين والمساحات. إذا أدرجت رسائل من مساحة لا تحتوي على رسائل، سيكون الردّ عنصرًا فارغًا. عند استخدام واجهة REST/HTTP، يحتوي الردّ على عنصر JSON فارغ، {}. على سبيل المثال، راجِع قائمة الرسائل. يتطلب مصادقة المستخدم. نطاقات التفويض يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

ListReactions

rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse) يعرض التفاعلات مع الرسائل. للحصول على مثال، يُرجى الاطّلاع على عرض قائمة بالتفاعلات مع رسالة. يتطلب مصادقة المستخدم. نطاقات الأذونات يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.readonly لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

ListSpaceEvents

rpc ListSpaceEvents(ListSpaceEventsRequest) returns (ListSpaceEventsResponse) يعرض هذا الإجراء الأحداث من مساحة Google Chat. يحتوي الحِمل على أحدث إصدار من مورد Chat لكل حدث. على سبيل المثال، إذا أدرجت أحداثًا عن أعضاء جدد في المساحة، يعرض الخادم Membership موردًا يحتوي على أحدث تفاصيل العضوية. إذا تمت إزالة المشتركين الجدد خلال الفترة المطلوبة، تحتوي حمولة الحدث على مورد Membership فارغ. يتطلب مصادقة المستخدم. لتضمين الأحداث، يجب أن يكون المستخدم الذي تمّت مصادقة هويته عضوًا في المساحة. على سبيل المثال، اطّلِع على إدراج الأحداث من مساحة في Google Chat. نطاقات الأذونات يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.messages https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.reactions https://www.googleapis.com/auth/chat.messages.reactions.readonly لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

ListSpaces

rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse) يسرد المساحات التي ينتمي إليها المتصل. لا يتم إدراج المحادثات الجماعية والرسائل المباشرة إلى أن يتم إرسال أول رسالة. على سبيل المثال، اطّلِع على قائمة المساحات. تتوافق مع أنواع المصادقة التالية: مصادقة التطبيقات مصادقة المستخدم لإدراج جميع المساحات المُسمّاة حسب مؤسسة Google Workspace، استخدِم الطريقة spaces.search() باستخدام امتيازات مشرف Workspace بدلاً من ذلك. نطاقات الأذونات يتطلب هذا الإعداد أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.bot لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

SearchSpaces

rpc SearchSpaces(SearchSpacesRequest) returns (SearchSpacesResponse) تعرض قائمة المساحات في مؤسسة Google Workspace استنادًا إلى بحث المشرف. يتطلب مصادقة المستخدم باستخدام امتيازات المشرف. في الطلب، اضبط السمة use_admin_access على true. نطاقات التفويض يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.admin.spaces.readonly لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

SetUpSpace

rpc SetUpSpace(SetUpSpaceRequest) returns (Space) يتم إنشاء مساحة وإضافة مستخدمين محدّدين إليها. تتم إضافة المستخدم المتصل تلقائيًا إلى المساحة، ويجب عدم تحديده كعضوية في الطلب. على سبيل المثال، يُرجى الاطّلاع على إعداد مساحة تتضمن الأعضاء الأولين. لتحديد المستخدمين المطلوب إضافتهم، أضِف العضويات باستخدام membership.member.name المناسب. لإضافة مستخدم فعلي، استخدِم users/{user}، حيث يمكن أن يكون {user} عنوان البريد الإلكتروني للمستخدم. بالنسبة إلى المستخدمين في مؤسسة Workspace نفسها، يمكن أن يكون {user} أيضًا id للمستخدم من People API أو id للمستخدم في Directory API. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي للمستخدم [e-mail] في People API هو 123456789، يمكنك إضافة المستخدم إلى المساحة من خلال ضبط membership.member.name على users/[e-mail] أو users/123456789. لتحديد مجموعات Google المطلوب إضافتها، أضِف العضويات باستخدام الرمز membership.group_member.name المناسب. لإضافة مجموعة Google أو دعوتها، استخدِم groups/{group}، حيث يكون {group} هو id للمجموعة من Cloud Identity Groups API. على سبيل المثال، يمكنك استخدام Cloud Identity Groups lookup API لاسترداد المعرّف 123456789 لعنوان البريد الإلكتروني للمجموعة [e-mail]، ثم يمكنك إضافة المجموعة إلى المساحة من خلال ضبط membership.group_member.name على groups/123456789. لا تتوفّر عناوين البريد الإلكتروني للمجموعات، ولا يمكن إضافة مجموعات Google إلا كأعضاء في مساحات مُسمّاة. في المساحة المُعنوَنة أو المحادثة الجماعية، إذا حظر المتصل أو بعض الأعضاء، أو لم يكن لديه الإذن بإضافة بعض الأعضاء، لن تتم إضافة هؤلاء الأعضاء إلى المساحة التي تم إنشاؤها. لإنشاء رسالة مباشرة بين المستخدم المتصل ومستخدم آخر، حدِّد عضوية واحدة بالضبط لتمثيل المستخدم. إذا حظر مستخدم مستخدمًا آخر، سيتعذّر إرسال الطلب ولن يتم إنشاء رسالة خاصة. لإنشاء رسالة مباشرة بين المستخدم المتصل وتطبيق الاتصال، يُرجى ضبط Space.singleUserBotDm على true وعدم تحديد أي اشتراكات. لا يمكنك استخدام هذه الطريقة إلا لإعداد رسالة مباشرة باستخدام تطبيق الاتصال. لإضافة تطبيق الاتصال كعضو في مساحة أو رسالة مباشرة حالية بين مستخدمَين بشريين، يُرجى الاطّلاع على مقالة دعوة مستخدم أو تطبيق إلى مساحة أو إضافتهما إليها. إذا كانت هناك رسالة مباشرة بين مستخدمَين، حتى عندما يحظر أحد المستخدمين الآخر عند تقديم الطلب، سيتم عرض الرسالة المباشرة الحالية. لا تتوفّر المسافات التي تتضمّن ردودًا في سلاسل منفصلة. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS عند إعداد مساحة، جرِّب displayName مختلفًا. قد تستخدم مساحة حالية في مؤسسة Google Workspace هذا الاسم المعروض. يتطلب مصادقة المستخدم. نطاقات الأذونات يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.create لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Membership) تعديل اشتراك للحصول على مثال، اطّلِع على تعديل عضوية مستخدم في مساحة. تتوافق مع أنواع المصادقة التالية: مصادقة التطبيقات من خلال موافقة المشرف في إصدار المطوّر مصادقة المستخدم: يمكنك مصادقة هذه الطريقة وتفويضها باستخدام امتيازات المشرف من خلال ضبط الحقل use_admin_access في الطلب. نطاقات الأذونات يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.app.memberships https://www.googleapis.com/auth/chat.admin.memberships https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.memberships لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

UpdateMessage

rpc UpdateMessage(UpdateMessageRequest) returns (Message) تعديل رسالة هناك فرق بين الطريقتَين patch وupdate. تستخدم الطريقة patch طلب patch بينما تستخدم الطريقة update طلب put. ننصحك باستخدام الطريقة patch. على سبيل المثال، راجِع تعديل رسالة. تتوافق مع أنواع المصادقة التالية: مصادقة التطبيق مصادقة المستخدم عند استخدام مصادقة التطبيقات، لا يمكن للطلبات تعديل إلا الرسائل التي تم إنشاؤها من خلال تطبيق Chat للاتصال. نطاقات التفويض يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.bot https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.messages لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

UpdateSpace

rpc UpdateSpace(UpdateSpaceRequest) returns (Space) يتم تعديل مساحة. على سبيل المثال، راجِع المقالة تعديل مساحة. في حال تعديل الحقل displayName وظهور رسالة الخطأ ALREADY_EXISTS، جرِّب استخدام اسم معروض مختلف. قد تستخدم مساحة حالية ضمن مؤسسة Google Workspace هذا الاسم المعروض. تتوافق مع أنواع المصادقة التالية: مصادقة التطبيقات من خلال موافقة المشرف في إصدار المطوّر مصادقة المستخدم: يمكنك مصادقة هذه الطريقة وتفويضها باستخدام امتيازات المشرف من خلال ضبط الحقل use_admin_access في الطلب. نطاقات الأذونات يتطلب أحد نطاقات OAuth التالية: https://www.googleapis.com/auth/chat.app.spaces https://www.googleapis.com/auth/chat.admin.spaces https://www.googleapis.com/auth/chat.import https://www.googleapis.com/auth/chat.spaces لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

UpdateSpaceReadState

rpc UpdateSpaceReadState(UpdateSpaceReadStateRequest) returns (SpaceReadState) تعدِّل حالة القراءة للمستخدم في مساحة، ويتم استخدامها لتحديد الرسائل المقروءة وغير المقروءة. على سبيل المثال، يمكنك الاطّلاع على تعديل حالة قراءة مساحة المستخدم. يتطلب مصادقة المستخدم. نطاقات التفويض يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/chat.users.readstate لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

AccessoryWidget

أداة تفاعلية واحدة أو أكثر تظهر في أسفل الرسالة لمعرفة التفاصيل، يُرجى الاطّلاع على إضافة تطبيقات مصغّرة تفاعلية في أسفل الرسالة.

الحقول
حقل الربط action نوع الإجراء. يمكن أن يكون action واحدًا فقط مما يلي:
button_list	ButtonList قائمة بالأزرار

ActionResponse

المَعلمات التي يمكن لتطبيق Chat استخدامها لضبط كيفية نشر ردّه

الحقول
type	ResponseType الإدخال فقط. نوع ردّ تطبيق Chat
url	string الإدخال فقط عنوان URL يمكن للمستخدمين مصادقته أو ضبطه. (لنوعي REQUEST_CONFIG فقط من الردود).
dialog_action	DialogAction الإدخال فقط ردّ على حدث تفاعل مرتبط بمربّع حوار يجب أن يكون مصحوبًا بـ ResponseType.Dialog.
updated_widget	UpdatedWidget الإدخال فقط. تمثّل هذه السمة استجابة التطبيق المصغّر.

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 مصفوفة من عناصر SelectionItem

UpdatedWidget

استجابة التطبيق المصغّر المعدَّل. يُستخدَم لتوفير خيارات الإكمال التلقائي لأداة ما.

الحقول
widget	string رقم تعريف التطبيق المصغّر المُعدَّل يجب أن يتطابق رقم التعريف مع رقم تعريف التطبيق المصغّر الذي أدّى إلى تقديم طلب التعديل.
حقل الاتحاد updated_widget. تم تعديل الأداة استجابةً لإجراء المستخدم. يمكن أن يكون updated_widget واحدًا فقط مما يلي:
suggestions	SelectionItems قائمة بنتائج الإكمال التلقائي للتطبيقات المصغّرة

ActionStatus

تُمثل حالة طلب استدعاء أو إرسال مربع حوار.

الحقول
status_code	Code رمز الحالة.
user_facing_message	string الرسالة التي يتم إرسالها إلى المستخدمين بشأن حالة طلبهم. في حال عدم ضبطها، يتم إرسال رسالة عامة استنادًا إلى status_code.

تعليق توضيحي

النتائج فقط. التعليقات التوضيحية المرتبطة بنص الرسالة العادي لإضافة تنسيق أساسي إلى رسالة نصية، راجِع تنسيق الرسائل النصية.

مثال على نص رسالة نص عادي:

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	AnnotationType نوع هذا التعليق التوضيحي.
length	int32 طول السلسلة الفرعية في نص الرسالة العادي الذي يتوافق معه هذا التعليق التوضيحي.
start_index	int32 فهرس البداية (يبدأ من 0 ويشمله) في نص الرسالة العادي الذي يتوافق معه هذا التعليق التوضيحي.
حقل الربط metadata بيانات وصفية إضافية عن التعليق التوضيحي يمكن أن يكون metadata واحدًا فقط مما يلي:
user_mention	UserMentionMetadata البيانات الوصفية التي يشير إليها المستخدم
slash_command	SlashCommandMetadata البيانات الوصفية لأمر الشرطة المائلة.
rich_link_metadata	RichLinkMetadata البيانات الوصفية لرابط تفاعلي

AnnotationType

نوع التعليق التوضيحي.

عمليات التعداد
ANNOTATION_TYPE_UNSPECIFIED	القيمة التلقائية للتعداد لا تستخدِم هذه الميزة.
USER_MENTION	ذكر مستخدم
SLASH_COMMAND	يتمّ استدعاء أمر يبدأ بشرطة مائلة.
RICH_LINK	تعليق توضيحي لرابط تفاعلي

AttachedGif

صورة GIF يتم تحديدها من خلال عنوان URL.

الحقول
uri	string النتائج فقط. عنوان URL الذي يستضيف صورة GIF

مرفق

مرفق في Google Chat

الحقول
name	string اسم المورد للمرفق، بالتنسيق spaces/{space}/messages/{message}/attachments/{attachment}
content_name	string النتائج فقط. اسم الملف الأصلي للمحتوى، وليس المسار الكامل.
content_type	string النتائج فقط. نوع محتوى الملف (نوع MIME)
thumbnail_uri	string النتائج فقط. عنوان URL للصورة المصغّرة الذي يجب استخدامه لمعاينة المرفق لمستخدم بشري. يجب ألا تستخدم تطبيقات المحادثات عنوان URL هذا لتنزيل محتوى المرفقات.
download_uri	string النتائج فقط. عنوان URL للتنزيل الذي يجب استخدامه للسماح لأحد المستخدمين بتنزيل المرفق. يجب ألا تستخدم تطبيقات المحادثات عنوان URL هذا لتنزيل محتوى المرفقات.
source	Source النتائج فقط. مصدر المرفق.
حقل الربط data_ref تشير البيانات إلى المرفق. يمكن أن يكون data_ref واحدًا فقط مما يلي:
attachment_data_ref	AttachmentDataRef مرجع إلى البيانات المرفقة يُستخدم هذا الحقل مع Media API لتنزيل بيانات المرفقات.
drive_data_ref	DriveDataRef النتائج فقط. مرجع إلى مرفق Google Drive يتم استخدام هذا الحقل مع Google Drive API.

المصدر

مصدر المرفق.

عمليات التعداد
SOURCE_UNSPECIFIED	محجوز.
DRIVE_FILE	الملف هو ملف Google Drive.
UPLOADED_CONTENT	تم تحميل الملف إلى Chat.

AttachmentDataRef

مرجع إلى البيانات المرفقة

الحقول
resource_name	string اسم المورد لبيانات المرفق. يُستخدم هذا الحقل مع Media API لتنزيل بيانات المرفقات.
attachment_upload_token	string رمز مميّز معتم يحتوي على مرجع إلى مرفق تم تحميله. يتعامل معها العملاء كسلسلة مبهمة وتُستخدَم لإنشاء رسائل Chat التي تتضمن مرفقات أو تعديلها.

CardWithId

بطاقة في رسالة Google Chat

يمكن لتطبيقات Chat فقط إنشاء البطاقات. إذا كان تطبيق Chat يستخدم المصادقة كمستخدم، لا يمكن أن تحتوي الرسالة على بطاقات.

تصميم البطاقات ومعاينتها باستخدام "أداة إنشاء البطاقات"

فتح "أداة إنشاء البطاقات"

الحقول
card_id	string مطلوبة إذا كانت الرسالة تحتوي على عدة بطاقات. معرّف فريد لبطاقة في رسالة
card	Card بطاقة. الحد الأقصى للحجم هو 32 كيلوبايت.

ChatSpaceLinkData

بيانات روابط مساحات Chat

الحقول
space	string مساحة مرجع "مساحة Chat" المرتبط التنسيق: spaces/{space}
thread	string سلسلة محادثات مورد مساحة Chat المرتبط تنسيق الملف: spaces/{space}/threads/{thread}
message	string رسالة مورد مساحة Chat المرتبطة. تنسيق الملف: spaces/{space}/messages/{message}

CompleteImportSpaceRequest

طلب رسالة لإكمال عملية الاستيراد للمساحة

الحقول
name	string مطلوب. اسم المورد لمساحة وضع الاستيراد تنسيق الملف: spaces/{space}

CompleteImportSpaceResponse

رسالة ردّ لإكمال عملية الاستيراد لمساحة

الحقول
space	Space مساحة وضع الاستيراد

ContextualAddOnMarkup

لا يتضمّن هذا النوع أيّ حقول.

ترميز يتيح للمطوّرين تحديد محتوى الإضافة السياقية

بطاقة

البطاقة هي عنصر واجهة مستخدِم يمكن أن يحتوي على تطبيقات مصغّرة لواجهة المستخدِم، مثل النصوص والصور.

الحقول
header	CardHeader عنوان البطاقة يحتوي العنوان عادةً على عنوان وصورة.
sections[]	Section يتم فصل الأقسام بفاصل سطر.
card_actions[]	CardAction إجراءات هذه البطاقة.
name	string اسم البطاقة

CardAction

إجراء البطاقة هو الإجراء المرتبط بالبطاقة. بالنسبة إلى بطاقة فواتير، يكون الإجراء النموذجي هو: حذف الفاتورة، أو البريد الإلكتروني، أو فتح الفاتورة في المتصفح.

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

الحقول
action_label	string التصنيف الذي كان معروضًا في عنصر قائمة الإجراءات
on_click	OnClick إجراء onclick لعنصر الإجراء هذا.

CardHeader

الحقول
title	string يجب تحديد العنوان. يكون للعنوان ارتفاع ثابت: إذا تم تحديد عنوان وعنوان فرعي، سيشغل كل منهما سطرًا واحدًا. إذا تم تحديد العنوان فقط، سيشغل كلا السطرين.
subtitle	string العنوان الفرعي لعنوان البطاقة.
image_style	ImageStyle نوع الصورة (على سبيل المثال، حدود مربّعة أو حدود دائرية).
image_url	string عنوان URL للصورة في عنوان البطاقة

ImageStyle

عمليات التعداد
IMAGE_STYLE_UNSPECIFIED
IMAGE	حد مربّع
AVATAR	حدود دائرية

القسم

يحتوي القسم على مجموعة من الأدوات التي يتم عرضها (عموديًا) بالترتيب الذي تم تحديدها به. على جميع المنصّات، تكون البطاقات ذات عرض ثابت وضيق، لذا لا حاجة حاليًا إلى سمات التنسيق (مثل float).

الحقول
header	string تمثّل هذه السمة عنوان القسم. يمكن استخدام النص المنسَّق. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace.
widgets[]	WidgetMarkup يجب أن يحتوي القسم على أداة واحدة على الأقل.

CreateCustomEmojiRequest

طلب لإنشاء رمز تعبيري مخصّص

إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.

الحقول
custom_emoji	CustomEmoji مطلوب. الرموز التعبيرية المخصصة التي سيتم إنشاؤها.

CreateMembershipRequest

طلب رسالة لإنشاء عضوية

الحقول
parent	string مطلوب. اسم المورد للمساحة التي تريد إنشاء الاشتراك لها. التنسيق: spaces/{space}
membership	Membership مطلوب. علاقة الاشتراك المطلوب إنشاؤها. يجب أن يحتوي الحقل memberType على مستخدِم تمت تعبئة الحقلَين user.name وuser.type فيه. سيحدّد الخادم اسمًا للمورد وسيؤدّي ذلك إلى استبدال أيّ شيء محدّد. عندما ينشئ تطبيق Chat علاقة عضوية لمستخدم بشري، يجب أن يستخدم نطاقات تفويض معيّنة ويضبط قيمًا معيّنة لحقول معيّنة: عند المصادقة كمستخدم، يكون نطاق تفويض chat.memberships مطلوبًا. عند المصادقة كتطبيق، يكون نطاق تفويض "chat.app.memberships" مطلوبًا. تتوفر المصادقة كتطبيق في معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها. يمكنك ضبط user.type على HUMAN، وضبط user.name بالتنسيق users/{user}، حيث يمكن أن يكون {user} هو عنوان البريد الإلكتروني للمستخدم. بالنسبة إلى المستخدمين في مؤسسة Workspace نفسها، يمكن أن يكون {user} أيضًا id لشخص من People API، أو id للمستخدم في Directory API. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي للمستخدم في People API في [e-mail] هو 123456789، يمكنك إضافة المستخدم إلى المساحة من خلال ضبط membership.member.name على users/[e-mail] أو users/123456789. عندما ينشئ تطبيق في Chat علاقة عضوية لنفسه، يجب المصادقة كمستخدم] واستخدام نطاق chat.memberships.app، وضبط user.type على BOT، وضبط user.name على users/app.
use_admin_access	bool عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاق OAuth 2.0 chat.admin.memberships. لا تتوفّر إمكانية إنشاء اشتراكات في التطبيقات أو إنشاء اشتراكات للمستخدمين خارج مؤسسة المشرف في Google Workspace باستخدام إذن وصول المشرف.

CreateMessageRequest

لإنشاء رسالة

الحقول
parent	string مطلوب. اسم مورد المساحة التي سيتم إنشاء رسالة فيها تنسيق الملف: spaces/{space}
message	Message مطلوب. نص الرسالة.
thread_key (deprecated)	string تم إيقاف هذا العنصر نهائيًا. اختياريّ. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام thread.thread_key بدلاً منها. رقم تعريف سلسلة المحادثات يمكن إدخال ما يصل إلى 4,000 حرف. لبدء سلسلة محادثات أو الإضافة إليها، أنشِئ رسالة وحدِّد threadKey أو thread.name. للاطّلاع على أمثلة على الاستخدام، يُرجى الاطّلاع على بدء سلسلة محادثات أو الردّ عليها.
request_id	string اختياريّ. معرّف طلب فريد لهذه الرسالة. يؤدي تحديد معرّف طلب حالي إلى عرض الرسالة التي تم إنشاؤها باستخدام هذا المعرّف بدلاً من إنشاء رسالة جديدة.
message_reply_option	MessageReplyOption اختياريّ. يحدِّد هذا الإعداد ما إذا كانت الرسالة تبدأ سلسلة محادثات أو تردّ على سلسلة محادثات. لا يمكن تنفيذ هذا الإجراء إلا في المساحات المُعنونة.
message_id	string اختياريّ. معرّف مخصّص لرسالة. تتيح تطبيقات Chat الحصول على رسالة أو تعديلها أو حذفها بدون الحاجة إلى تخزين رقم التعريف الذي يحدّده النظام في اسم مورد الرسالة (الممثّل في حقل name للرسالة). يجب أن تستوفي قيمة هذا الحقل المتطلبات التالية: يبدأ بـ client-. على سبيل المثال، client-custom-name هو معرّف مخصّص صالح، على عكس custom-name. يحتوي على ما يصل إلى 63 حرفًا وأحرفًا صغيرة وأرقامًا وواصلات فقط. أن تكون فريدة داخل مساحة لا يمكن لتطبيق Chat استخدام المعرّف المخصّص نفسه لرسائل مختلفة. لمعرفة التفاصيل، يُرجى الاطّلاع على تسمية رسالة.

MessageReplyOption

لتحديد كيفية الرد على رسالة. ويمكن إضافة المزيد من الولايات في المستقبل.

عمليات التعداد
MESSAGE_REPLY_OPTION_UNSPECIFIED	تلقائي: بدء سلسلة محادثات جديدة يؤدي استخدام هذا الخيار إلى تجاهل أي thread ID أو thread_key تم تضمينه.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD	ينشئ الرسالة كرد على سلسلة المحادثات المحدّدة من قِبل "thread ID" أو "thread_key". إذا فشلت، تبدأ الرسالة سلسلة محادثات جديدة بدلاً من ذلك.
REPLY_MESSAGE_OR_FAIL	ينشئ الرسالة كرد على سلسلة المحادثات المحدّدة من قِبل "thread ID" أو "thread_key". وفي حال استخدام thread_key جديدة، يتم إنشاء سلسلة محادثات جديدة. وإذا تعذَّر إنشاء الرسالة، سيتم عرض الخطأ NOT_FOUND بدلاً من ذلك.

CreateReactionRequest

لإنشاء تفاعل مع رسالة

الحقول
parent	string مطلوب. الرسالة التي يتم فيها إنشاء التفاعل التنسيق: spaces/{space}/messages/{message}
reaction	Reaction مطلوب. التفاعل الذي يتم إنشاؤه

CreateSpaceRequest

طلب لإنشاء مساحة مُسَمّاة بدون أعضاء

الحقول
space	Space مطلوب. يجب تعبئة حقلَي displayName وspaceType. يُسمَح باستخدام SpaceType.SPACE فقط. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS، جرِّب استخدام displayName مختلف. قد تستخدم مساحة حالية ضمن مؤسسة Google Workspace هذا الاسم المعروض. إذا كنت مشتركًا في برنامج معاينة المطوّرين، يمكن استخدام SpaceType.GROUP_CHAT إذا تم ضبط importMode على true. يتم تخصيص المسافة name على الخادم، لذا سيتم تجاهل أي عنصر محدَّد في هذا الحقل.
request_id	string اختياريّ. معرّف فريد لهذا الطلب ننصحك باستخدام معرّف فريد عالمي (UUID) عشوائي. يؤدي تحديد معرّف طلب حالي إلى عرض المساحة التي تم إنشاؤها باستخدام هذا المعرّف بدلاً من إنشاء مساحة جديدة. يؤدي تحديد معرّف طلب حالي من تطبيق Chat نفسه مع مستخدم مختلف تمت مصادقته إلى عرض رسالة خطأ.

CustomEmoji

يمثّل رمز إيموجي مخصّصًا.

الحقول
name	string المُعرّف. اسم مورد الرمز التعبيري المخصّص، الذي حدّده الخادم. التنسيق: customEmojis/{customEmoji} معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها.
uid	string النتائج فقط. مفتاح فريد لمورد الرموز التعبيرية المخصّصة.
emoji_name	string غير قابل للتغيير. الاسم الذي يوفّره المستخدم للرمز التعبيري المخصّص، والذي يكون فريدًا في المؤسسة مطلوب عند إنشاء الرمز التعبيري المخصّص، ويتم إخراجه فقط في الحالات الأخرى. يجب أن تبدأ أسماء الرموز التعبيرية وتنتهي بنقطتَين، ويجب أن تكون بأحرف صغيرة ويمكن أن تحتوي فقط على أحرف أبجدية رقمية وواصلات وشرطات سفلية. يجب استخدام الواصلات والشرطات السفلية لفصل الكلمات ولا يمكن استخدامها بشكل متتابع. مثلاً: :valid-emoji-name: إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.
temporary_image_uri	string النتائج فقط. عنوان URL للصورة المخصّصة للرموز التعبيرية، ويجب أن يكون صالحًا لمدة 10 دقائق على الأقل. يُرجى العِلم أنّه لا تتم تعبئة هذا الحقل في الردّ عند إنشاء الرمز التعبيري المخصَّص. إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.
payload	CustomEmojiPayload الإدخال فقط بيانات الحمولة إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.

CustomEmojiPayload

بيانات الحمولة الخاصة بالرمز التعبيري المخصّص

معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها.

الحقول
file_content	bytes مطلوب. الإدخال فقط. الصورة المستخدمة للرمز التعبيري المخصّص يجب ألا يزيد حجم الحمولة عن 256 كيلوبايت، ويجب أن تتراوح أبعاد الصورة بين 64 و500 بكسل. إنّ القيود عرضة للتغيير.
filename	string مطلوب. الإدخال فقط اسم ملف الصورة. امتدادات الملفات المتوافقة: .png و.jpg و.gif.

DeleteCustomEmojiRequest

طلب لحذف رمز تعبيري مخصّص

إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.

الحقول
name	string مطلوب. اسم مورد الرمز التعبيري المخصّص المطلوب حذفه. تنسيق الملف: customEmojis/{customEmoji} يمكنك استخدام اسم الرمز التعبيري كاسم بديل لـ {customEmoji}. على سبيل المثال، customEmojis/:example-emoji: حيث يكون :example-emoji: هو اسم الرمز التعبيري للرمز التعبيري المخصّص.

DeleteMembershipRequest

طلب حذف عضوية في مساحة

الحقول
name	string مطلوب. اسم مورد العضوية المطلوب حذفه. يمكن لتطبيقات المحادثة حذف العضويات الخاصة بالمستخدمين أو العضويات الخاصة بها. لا يمكن لتطبيقات المحادثة حذف الاشتراكات في التطبيقات الأخرى. عند حذف اشتراك مستخدم، يجب استخدام النطاق chat.memberships وتنسيق spaces/{space}/members/{member}. يمكنك استخدام عنوان البريد الإلكتروني كعنوان بديل لـ {member}. على سبيل المثال، spaces/{space}/members/[e-mail] حيث يكون [e-mail] هو عنوان البريد الإلكتروني لمستخدم Google Chat. عند حذف اشتراك في تطبيق، يجب استخدام نطاق chat.memberships.app وتنسيق spaces/{space}/members/app. التنسيق: spaces/{space}/members/{member} أو spaces/{space}/members/app
use_admin_access	bool عند true، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace للمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاق OAuth 2.0 chat.admin.memberships. لا يمكنك حذف الاشتراكات الداعمة للتطبيقات في مساحة باستخدام إذن وصول المشرف.

DeleteMessageRequest

طلب حذف رسالة

الحقول
name	string مطلوب. اسم المورد للرسالة تنسيق الملف: spaces/{space}/messages/{message} إذا كنت قد حدّدت معرّفًا مخصّصًا لرسالتك، يمكنك استخدام القيمة من حقل clientAssignedMessageId لـ {message}. لمعرفة التفاصيل، يُرجى الاطّلاع على تسمية رسالة.
force	bool عند true، يؤدي حذف رسالة إلى حذف الردود المتسلسلة عليها أيضًا. في حال تفعيل false، إذا كانت الرسالة تحتوي على ردود متسلسلة، سيتعذّر حذفها. لا ينطبق إلا عند المصادقة بصفتك مستخدمًا. لا يؤثّر ذلك في المصادقة كتطبيق Chat.

DeleteReactionRequest

حذف تفاعل مع رسالة

الحقول
name	string مطلوب. اسم التفاعل المطلوب حذفه. تنسيق الملف: spaces/{space}/messages/{message}/reactions/{reaction}

DeleteSpaceRequest

طلب لحذف مساحة

الحقول
name	string مطلوب. اسم المورد للمساحة المطلوب حذفها التنسيق: spaces/{space}
use_admin_access	bool عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاق OAuth 2.0 chat.admin.delete.

DeletionMetadata

معلومات حول رسالة محذوفة يتم حذف رسالة عند ضبط delete_time.

الحقول
deletion_type	DeletionType يشير إلى الشخص الذي حذف الرسالة.

DeletionType

المستخدم الذي حذف الرسالة وكيفية حذفها. ويمكن إضافة المزيد من القيم في المستقبل.

عمليات التعداد
DELETION_TYPE_UNSPECIFIED	هذه القيمة غير مستخدمة.
CREATOR	حذف المستخدم رسالته.
SPACE_OWNER	حذف مالك المساحة الرسالة.
ADMIN	حذف مشرف Google Workspace الرسالة.
APP_MESSAGE_EXPIRY	حذف تطبيق Chat رسالته عند انتهاء صلاحيتها.
CREATOR_VIA_APP	حذَف تطبيق Chat الرسالة نيابةً عن المستخدم.
SPACE_OWNER_VIA_APP	حذف تطبيق Chat الرسالة نيابةً عن مالك المساحة.

مربّع حوار

ملفوف حول نص البطاقة في مربّع الحوار

الحقول
body	Card الإدخال فقط نص مربع الحوار الذي يتم عرضه في شكل مربّع لا تتوافق تطبيقات Google Chat مع عناصر البطاقات التالية: DateTimePicker وOnChangeAction.

DialogAction

يحتوي على مربع حوار ورمز حالة طلب.

الحقول
action_status	ActionStatus الإدخال فقط. حالة طلب إما لاستدعاء أو إرسال مربع حوار. يعرض حالة ورسالة للمستخدمين، إذا لزم الأمر. على سبيل المثال، في حال حدوث خطأ أو نجاح.
حقل الربط action الإجراء الذي سيتم تنفيذه. يمكن أن يكون action واحدًا فقط مما يلي:
dialog	Dialog الإدخال فقط مربع حوار للطلب.

DriveDataRef

إشارة إلى بيانات مرفق في مساحة التخزين

الحقول
drive_file_id	string رقم تعريف ملف Drive. الاستخدام مع Drive API

DriveLinkData

بيانات روابط Google Drive

الحقول
drive_data_ref	DriveDataRef DriveDataRef الذي يشير إلى ملف Google Drive.
mime_type	string نوع MIME لمورد Google Drive المرتبط.

رموز الإيموجي

رمز تعبيري يُستخدم كتفاعل مع رسالة.

الحقول
حقل الاتحاد content. محتوى رمز الإيموجي يمكن أن يكون content واحدًا فقط مما يلي:
unicode	string يشير ذلك المصطلح إلى رمز تعبيري أساسي يتم تمثيله بسلسلة بترميز يونيكود.
custom_emoji	CustomEmoji النتائج فقط. رمز تعبيري مخصّص

EmojiReactionSummary

عدد المستخدمين الذين تفاعلوا مع رسالة باستخدام رمز تعبيري معيّن

الحقول
emoji	Emoji الرمز التعبيري المرتبط بالتفاعلات
reaction_count	int32 إجمالي عدد التفاعلات باستخدام الرمز التعبيري المرتبط

FindDirectMessageRequest

طلب للحصول على مساحة رسالة مباشرة استنادًا إلى مورد المستخدم.

الحقول

name

string مطلوب. اسم المورد للمستخدم الذي تريد العثور على رسالة مباشرة معه. التنسيق: users/{user}، حيث يكون {user} هو id الخاص بالشخص من People API، أو id الخاص بالمستخدم في Directory API. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي في People API هو 123456789، يمكنك العثور على رسالة مباشرة مع هذا المستخدم باستخدام users/123456789 كـ name. عند المصادقة كمستخدم، يمكنك استخدام عنوان البريد الإلكتروني كاسم مستعار لـ {user}. على سبيل المثال، users/[e-mail] حيث يكون [e-mail] هو عنوان البريد الإلكتروني لمستخدم Google Chat.

GetAttachmentRequest

اطلب الحصول على مرفق.

الحقول
name	string مطلوب. اسم المورد للمرفق، بالتنسيق spaces/{space}/messages/{message}/attachments/{attachment}

GetCustomEmojiRequest

طلب عرض رمز تعبيري مخصّص واحد

إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.

الحقول
name	string مطلوب. اسم مورد الرمز التعبيري المخصّص. التنسيق: customEmojis/{customEmoji} يمكنك استخدام اسم الرمز التعبيري كاسم بديل لـ {customEmoji}. على سبيل المثال، customEmojis/:example-emoji: حيث يكون :example-emoji: هو اسم رمز تعبيري مخصّص.

GetMembershipRequest

طلب الحصول على عضوية في مساحة

الحقول
name	string مطلوب. اسم مورد العضوية المطلوب استرداده. للحصول على الاشتراك في التطبيق من خلال مصادقة المستخدم، يمكنك استخدام spaces/{space}/members/app إذا أردت. التنسيق: spaces/{space}/members/{member} أو spaces/{space}/members/app يمكنك استخدام البريد الإلكتروني للمستخدم كاسم مستعار للبريد الإلكتروني {member}. على سبيل المثال، spaces/{space}/members/[e-mail] حيث [e-mail] هو عنوان البريد الإلكتروني لمستخدم Google Chat.
use_admin_access	bool عند true، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace للمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاقات OAuth 2.0 chat.admin.memberships أو chat.admin.memberships.readonly. لا يمكن تفعيل ميزة "العضوية في التطبيقات" في مساحة عند استخدام إذن وصول المشرف.

GetMessageRequest

يمكنك طلب تلقّي رسالة.

الحقول
name	string مطلوب. اسم المورد للرسالة تنسيق الملف: spaces/{space}/messages/{message} في حال ضبط معرّف مخصّص لرسالتك، يمكنك استخدام القيمة من الحقل clientAssignedMessageId لـ {message}. للحصول على التفاصيل، يُرجى الاطِّلاع على تسمية رسالة.

GetSpaceEventRequest

يمكنك طلب تلقّي رسالة لتلقّي حدث في المساحة.

الحقول
name	string مطلوب. اسم المورد لحدث المساحة تنسيق الملف: spaces/{space}/spaceEvents/{spaceEvent}

GetSpaceReadStateRequest

طلب رسالة لواجهة برمجة تطبيقات GetSpaceReadState.

الحقول

name

string مطلوب. اسم المورد لحالة قراءة المساحة المطلوب استردادها لا تتوافق هذه الميزة إلا مع الحصول على حالة القراءة للمستخدم المتصل. للإشارة إلى المستخدم المتصل، اضبط أحد الخيارَين التاليَين: الاسم المستعار me مثلاً: users/me/spaces/{space}/spaceReadState عنوان بريده الإلكتروني على Workspace. مثلاً: users/[e-mail]/spaces/{space}/spaceReadState رقم تعريف المستخدم مثلاً: users/123456789/spaces/{space}/spaceReadState التنسيق: users/{user}/spaces/{space}/spaceReadState

GetSpaceRequest

طلب عرض مسافة واحدة

الحقول
name	string مطلوب. اسم مورد المساحة، بالتنسيق spaces/{space} تنسيق الملف: spaces/{space}
use_admin_access	bool عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاقات OAuth 2.0 chat.admin.spaces أو chat.admin.spaces.readonly.

GetThreadReadStateRequest

طلب رسالة لواجهة برمجة تطبيقات GetThreadReadStateRequest.

الحقول

name

string مطلوب. اسم المورد لحالة قراءة سلسلة المحادثات المطلوب استرجاعها لا تتيح هذه الوظيفة سوى الحصول على حالة القراءة للمستخدم المتصل. للإشارة إلى المستخدم المتصل، اضبط أحد الخيارَين التاليَين: العنوان البديل للبريد الإلكتروني me مثلاً: users/me/spaces/{space}/threads/{thread}/threadReadState عنوان البريد الإلكتروني في Workspace مثلاً: users/[e-mail]/spaces/{space}/threads/{thread}/threadReadState رقم تعريف المستخدم مثلاً: users/123456789/spaces/{space}/threads/{thread}/threadReadState التنسيق: users/{user}/spaces/{space}/threads/{thread}/threadReadState

مجموعة

مجموعة Google في Google Chat

الحقول
name	string اسم المورد لمجموعة Google. يمثّل مجموعة في Cloud Identity Groups API. التنسيق: groups/{group}

HistoryState

حالة السجلّ للرسائل والمساحات تحدِّد هذه السياسة مدة الاحتفاظ بالرسائل وسلاسل المحادثات بعد الإنشاء.

عمليات التعداد
HISTORY_STATE_UNSPECIFIED	القيمة التلقائية. لا تستخدِم هذه الطريقة.
HISTORY_OFF	السجلّ غير مفعّل. يتم الاحتفاظ بالرسائل وسلاسل المحادثات لمدة 24 ساعة.
HISTORY_ON	السجلّ مفعَّل. تحدِّد قواعد الاحتفاظ بالبيانات في Vault الخاصة بالمؤسسة مدة الاحتفاظ بالرسائل سلاسل المحادثات.

ListCustomEmojisRequest

طلب لعرض قائمة رموز تعبيرية مخصّصة

معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها.

الحقول
page_size	int32 اختياريّ. تم عرض الحد الأقصى لعدد الرموز التعبيرية المخصّصة. ويمكن أن تعرض الخدمة عددًا أقل من رموز الإيموجي المخصّصة من هذه القيمة. إذا لم يتم تحديد عدد، تكون القيمة التلقائية هي 25. الحد الأقصى للقيمة هو 200؛ تغيرت القيم الأعلى من 200 إلى 200.
page_token	string اختياريّ. (في حال الاستئناف من استعلام سابق.) رمز تعريف صفحة تم تلقّيه من طلب سابق لرمز تعبيري مخصّص لقائمة. يمكنك توفير هذا الحقل لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق قيمة الفلتر مع الاستدعاء الذي قدّم الرمز المميز للصفحة. وقد يؤدي تمرير قيمة مختلفة إلى نتائج غير متوقَّعة.
filter	string اختياريّ. فلتر طلب بحث يتيح هذا الخيار الفلترة حسب صانع المحتوى. لفلترة المحتوى حسب صانع المحتوى، يجب تحديد قيمة صالحة. في الوقت الحالي، يمكن فقط لكل من creator("users/me") وNOT creator("users/me") فلترة الرموز التعبيرية المخصّصة حسب ما إذا كان المستخدم المتصل هو من أنشأ هذه الرموز أم لا. على سبيل المثال، يعرض الطلب التالي رمزًا تعبيريًا مخصّصًا أنشأه المتصل: creator("users/me") يرفض الخادم طلبات البحث غير الصالحة ويعرض خطأ INVALID_ARGUMENT.

ListCustomEmojisResponse

ردّ على قائمة برموز إيموجي مخصّصة

معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها.

الحقول
custom_emojis[]	CustomEmoji قائمة بدون ترتيب قائمة برموز الإيموجي المخصّصة في الصفحة المطلوبة (أو الأولى)
next_page_token	string رمز مميز يمكنك إرساله كـ pageToken لاسترداد الصفحة التالية من النتائج. وإذا كان هذا الحقل فارغًا، لن تظهر أي صفحات لاحقة.

ListMembershipsRequest

رسالة طلب إدراج الاشتراكات الداعمة

الحقول
parent	string مطلوب. اسم المورد للمساحة المطلوب جلب قائمة الاشتراكات فيها. التنسيق: spaces/{space}
page_size	int32 اختياريّ. الحد الأقصى لعدد الاشتراكات المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. وفي حال عدم تحديد قيمة هذا الخيار، يتم إرجاع 100 عضوية كحدّ أقصى. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000. تعرِض القيم السلبية خطأ INVALID_ARGUMENT.
page_token	string اختياريّ. رمز مميّز للصفحة، تم تلقّيه من مكالمة سابقة لإدراج العضويات في القناة. قدِّم هذه المَعلمة لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق جميع المعلمات الأخرى المقدّمة مع الاستدعاء الذي قدّم الرمز المميز للصفحة. قد يؤدي تمرير قيم مختلفة إلى المعلَمات الأخرى إلى نتائج غير متوقعة.
filter	string اختياريّ. فلتر طلب بحث يمكنك فلترة الاشتراكات الداعمة حسب دور العضو (role) ونوعه (member.type). لفلترة البيانات حسب الدور، اضبط role على ROLE_MEMBER أو ROLE_MANAGER. للفلترة حسب النوع، اضبط member.type على HUMAN أو BOT. يمكنك أيضًا الفلترة حسب member.type باستخدام عامل التشغيل !=. للفلترة حسب كل من الدور والنوع، استخدِم عامل التشغيل AND. لفلترة البيانات حسب الدور أو النوع، استخدِم عامل التشغيل OR. يجب إدخال إما member.type = "HUMAN" أو member.type != "BOT" عند ضبط use_admin_access على "صحيح". سيتم رفض فلاتر أنواع الأعضاء الأخرى. على سبيل المثال، طلبات البحث التالية صالحة: role = "ROLE_MANAGER" OR role = "ROLE_MEMBER" member.type = "HUMAN" AND role = "ROLE_MANAGER" member.type != "BOT" طلبات البحث التالية غير صالحة: member.type = "HUMAN" AND member.type = "BOT" role = "ROLE_MANAGER" AND role = "ROLE_MEMBER" يرفض الخادم طلبات البحث غير الصالحة مع ظهور الخطأ INVALID_ARGUMENT.
show_groups	bool اختياريّ. عند تلقّي عضوية في قناة true، يتم أيضًا عرض العضويات المرتبطة بـ Google Group، بالإضافة إلى أنواع أخرى من العضويات. في حال ضبط filter، لا يتم عرض العضويات في Google Group التي لا تطابق معايير الفلتر.
show_invited	bool اختياريّ. عند true، يتم أيضًا عرض العضويات المرتبطة بأعضاء invited، بالإضافة إلى أنواع أخرى من العضويات. في حال ضبط فلتر، لا يتم عرض اشتراكات invited التي لا تطابق معايير الفلتر. تتطلب حاليًا مصادقة المستخدم.
use_admin_access	bool عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاق OAuth 2.0 chat.admin.memberships.readonly أو chat.admin.memberships. لا يمكن إدراج عضويات التطبيقات في مساحة عند استخدام إذن وصول المشرف.

ListMembershipsResponse

الرد لإدراج أعضاء المساحة في المساحة

الحقول
memberships[]	Membership قائمة بدون ترتيب قائمة العضويات الظاهرة على الصفحة المطلوبة (أو الأولى)
next_page_token	string رمز مميّز يمكنك إرساله على شكل pageToken لاسترداد الصفحة التالية من النتائج. وإذا كان هذا الحقل فارغًا، لن تظهر أي صفحات لاحقة.

ListMessagesRequest

يسرد الرسائل في المساحة المحدّدة التي يكون المستخدم عضوًا فيها.

الحقول
parent	string مطلوب. اسم المورد للمساحة التي تريد إدراج الرسائل منها. تنسيق الملف: spaces/{space}
page_size	int32 الحد الأقصى لعدد الرسائل التي يتم عرضها. قد تعرض الخدمة عددًا أقل من الرسائل مقارنةً بهذه القيمة. إذا لم يتم تحديد عدد، يتم عرض 25 عنصرًا بحد أقصى. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000. تعرِض القيم السلبية خطأ INVALID_ARGUMENT.
page_token	string اختياري، في حال استئناف طلب بحث سابق رمز صفحة تم تلقّيه من طلب سابق لرسائل القائمة قدِّم هذه المَعلمة لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة مع الطلب الذي قدّم رمز تعريف الصفحة. وقد يؤدي ضبط قيم مختلفة للمَعلمات الأخرى إلى نتائج غير متوقّعة.
filter	string فلتر طلب بحث يمكنك فلترة الرسائل حسب التاريخ (create_time) وسلسلة المحادثات (thread.name). لفلترة الرسائل حسب تاريخ إنشائها، حدِّد create_time بطابع زمني بتنسيق RFC-3339 وعلامات اقتباس مزدوجة. على سبيل المثال، "2023-04-21T11:30:00-04:00". يمكنك استخدام عامل التشغيل "أكبر من" > لعرض الرسائل التي تم إنشاؤها بعد طابع زمني معيّن، أو عامل التشغيل "أقل من" < لعرض الرسائل التي تم إنشاؤها قبل طابع زمني معيّن. لفلترة الرسائل ضمن فاصل زمني، استخدِم عامل التشغيل AND بين طابعَي زمنيَّين. للفلترة حسب سلسلة المحادثات، حدِّد thread.name، بتنسيق spaces/{space}/threads/{thread}. يمكنك تحديد thread.name واحدة فقط لكل طلب بحث. لفلترة الرسائل حسب سلسلة المحادثات والتاريخ معًا، استخدِم عامل التشغيل AND في طلب البحث. على سبيل المثال، تكون طلبات البحث التالية صالحة: create_time > "2012-04-21T11:30:00-04:00" create_time > "2012-04-21T11:30:00-04:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 create_time > "2012-04-21T11:30:00+00:00" AND create_time < "2013-01-01T00:00:00+00:00" AND thread.name = spaces/AAAAAAAAAAA/threads/123 thread.name = spaces/AAAAAAAAAAA/threads/123 يرفض الخادم طلبات البحث غير الصالحة ويعرض خطأ INVALID_ARGUMENT.
order_by	string اختياري، في حال الاستئناف من استعلام سابق. كيفية ترتيب قائمة الرسائل حدِّد قيمة لترتيبها حسب عملية ترتيب. في ما يلي القيم الصالحة لعملية الترتيب: ASC للترتيب التصاعدي. DESC للترتيب التنازلي الترتيب التلقائي هو create_time ASC.
show_deleted	bool ما إذا كنت تريد تضمين الرسائل المحذوفة تتضمّن الرسائل المحذوفة وقت الحذف والبيانات الوصفية حول عملية الحذف، ولكن لا يتوفّر محتوى الرسالة.

ListMessagesResponse

رسالة ردّ على إدراج الرسائل

الحقول
messages[]	Message قائمة الرسائل
next_page_token	string يمكنك إرسال رمز مميّز كـ pageToken لاسترداد الصفحة التالية من النتائج. وإذا كان هذا الحقل فارغًا، لن تظهر أي صفحات لاحقة.

ListReactionsRequest

يعرض التفاعلات مع الرسائل.

الحقول
parent	string مطلوب. الرسالة التي تفاعل معها المستخدمون. التنسيق: spaces/{space}/messages/{message}
page_size	int32 اختياريّ. الحد الأقصى لعدد التفاعلات المعروضة يمكن أن تعرض الخدمة عددًا أقل من التفاعلات مقارنةً بهذه القيمة. وفي حال عدم تحديد القيمة، تكون القيمة التلقائية هي 25. الحد الأقصى للقيمة هو 200، ويتم تغيير القيم التي تزيد عن 200 إلى 200.
page_token	string اختياريّ. (في حال استئناف طلب بحث سابق) رمز مميّز للصفحة تم تلقّيه من طلب سابق لعرض التفاعلات مع المحتوى. يمكنك توفير هذا الحقل لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق قيمة الفلتر مع الاستدعاء الذي قدّم الرمز المميز للصفحة. وقد يؤدي تمرير قيمة مختلفة إلى نتائج غير متوقَّعة.
filter	string اختياريّ. فلتر طلب بحث يمكنك فلترة التفاعلات حسب الرمز التعبيري (emoji.unicode أو emoji.custom_emoji.uid) والمستخدم (user.name). لفلترة التفاعلات لرموز تعبيرية أو مستخدمين متعدّدين، يمكنك دمج الحقول المتشابهة باستخدام عامل التشغيل OR، مثل emoji.unicode = "🙂" OR emoji.unicode = "👍" وuser.name = "users/AAAAAA" OR user.name = "users/BBBBBB". لفلترة التفاعلات حسب الرموز التعبيرية والمستخدم، استخدِم عامل التشغيل AND، مثل emoji.unicode = "🙂" AND user.name = "users/AAAAAA". إذا كان طلب البحث يستخدم كلاً من AND وOR، اجمعهما باستخدام قوسَين. على سبيل المثال، تكون طلبات البحث التالية صالحة: user.name = "users/{user}" emoji.unicode = "🙂" emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" OR emoji.unicode = "👍" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" AND user.name = "users/{user}" (emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}") AND user.name = "users/{user}" طلبات البحث التالية غير صالحة: emoji.unicode = "🙂" AND emoji.unicode = "👍" emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}" emoji.unicode = "🙂" OR user.name = "users/{user}" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR user.name = "users/{user}" emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" AND user.name = "users/{user}" يرفض الخادم طلبات البحث غير الصالحة ويعرض خطأ INVALID_ARGUMENT.

ListReactionsResponse

ردّ على طلب التفاعلات مع قائمة

الحقول
reactions[]	Reaction قائمة بالتفاعلات في الصفحة المطلوبة (أو الأولى)
next_page_token	string رمز المتابعة لاسترداد الصفحة التالية من النتائج هذا الحقل فارغ للصفحة الأخيرة من النتائج.

ListSpaceEventsRequest

رسالة طلب إدراج أحداث المساحة

الحقول
parent	string مطلوب. اسم المورد لمساحة Google Chat التي وقعت فيها الأحداث التنسيق: spaces/{space}
page_size	int32 اختياريّ. الحد الأقصى لعدد أحداث المساحة التي يتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. تعرض القيم السالبة خطأ INVALID_ARGUMENT.
page_token	string رمز تعريف صفحة تم تلقّيه من طلب سابق لأحداث مساحة القائمة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم البيانات إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة لعرض أحداث المساحة مع الطلب الذي قدّم رمز تعريف الصفحة. وقد يؤدي ضبط قيم مختلفة للمَعلمات الأخرى إلى نتائج غير متوقّعة.
filter	string مطلوب. فلتر طلب بحث عليك تحديد نوع حدث واحد على الأقل (event_type) باستخدام عامل التشغيل :. لفلترة البيانات حسب أنواع أحداث متعددة، استخدِم عامل التشغيل OR. احذف أنواع الأحداث المجمّعة في الفلتر. يعرض الطلب تلقائيًا أي أحداث مجمّعة ذات صلة. على سبيل المثال، إذا كنت تفلتر حسب التفاعلات الجديدة (google.workspace.chat.reaction.v1.created)، يعرض الخادم أيضًا أحداث التفاعلات الجديدة المجمّعة (google.workspace.chat.reaction.v1.batchCreated). للحصول على قائمة بأنواع الأحداث المتوافقة، اطّلِع على SpaceEvents المستندات المرجعية. يمكنك أيضًا اختياريًا الفلترة حسب وقت البدء (start_time) ووقت الانتهاء (end_time): start_time: الطابع الزمني الحصري الذي يمكن من خلاله بدء إدراج أحداث المساحة يمكنك سرد الأحداث التي تمت قبل ما يصل إلى 28 يومًا. في حال عدم تحديد ذلك، سيتم عرض أحداث المساحة من آخر 28 يومًا. end_time: الطابع الزمني الشامل الذي يتم إدراج أحداث المساحة حتى تاريخه في حال عدم تحديده، يتم إدراج الأحداث حتى وقت الطلب. لتحديد وقت بدء أو انتهاء، استخدِم عامل التشغيل == والتنسيق RFC-3339. للفلترة حسب كل من start_time وend_time، استخدِم عامل التشغيل AND. على سبيل المثال، تكون طلبات البحث التالية صالحة: start_time="2023-08-23T19:20:33+00:00" AND end_time="2023-08-23T19:21:54+00:00" start_time="2023-08-23T19:20:33+00:00" AND (event_types:"google.workspace.chat.space.v1.updated" OR event_types:"google.workspace.chat.message.v1.created") طلبات البحث التالية غير صالحة: start_time="2023-08-23T19:20:33+00:00" OR end_time="2023-08-23T19:21:54+00:00" event_types:"google.workspace.chat.space.v1.updated" AND event_types:"google.workspace.chat.message.v1.created" يرفض الخادم طلبات البحث غير الصالحة مع ظهور الخطأ INVALID_ARGUMENT.

ListSpaceEventsResponse

رسالة ردّ على بيانات أحداث المساحة

الحقول
space_events[]	SpaceEvent يتم عرض النتائج بترتيب زمني (الحدث الأقدم أولاً). ملاحظة: لا يتم عرض الحقل permissionSettings في عنصر Space لطلبات القوائم.
next_page_token	string رمز المتابعة المستخدَم لجلب المزيد من الأحداث في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

ListSpacesRequest

طلب بعرض المساحات التي يكون المتصل عضوًا فيها

الحقول
page_size	int32 اختياريّ. الحد الأقصى لعدد المسافات المعروضة قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد المسافات، يتم عرض 100 مسافة كحد أقصى. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000. تعرِض القيم السلبية خطأ INVALID_ARGUMENT.
page_token	string اختياريّ. رمز تعريف صفحة تم تلقّيه من مكالمة سابقة لطلب قائمة المساحات قدِّم هذه المَعلمة لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق قيمة الفلتر مع الطلب الذي قدّم الرمز المميّز للصفحة. قد يؤدي إدخال قيمة مختلفة إلى نتائج غير متوقّعة.
filter	string اختياريّ. فلتر طلب بحث يمكنك فلترة المساحات حسب نوع المساحة (space_type). لفلترة البيانات حسب نوع المساحة، عليك تحديد قيمة صحيحة لقائمة القيم المحدّدة مسبقًا، مثل SPACE أو GROUP_CHAT (لا يمكن أن تكون قيمة space_type هي SPACE_TYPE_UNSPECIFIED). لإجراء طلب بحث عن أنواع مساحات متعددة، استخدِم عامل التشغيل OR. على سبيل المثال، طلبات البحث التالية صالحة: space_type = "SPACE" spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE" يرفض الخادم طلبات البحث غير الصالحة مع ظهور الخطأ INVALID_ARGUMENT.

ListSpacesResponse

ردّ على طلب قائمة المساحات

الحقول
spaces[]	Space قائمة المساحات في الصفحة المطلوبة (أو الأولى) ملاحظة: لا يتم عرض الحقل permissionSettings في عنصر المساحة لطلبات القائمة.
next_page_token	string يمكنك إرسال رمز مميّز كـ pageToken لاسترداد الصفحة التالية من النتائج. إذا كانت فارغة، يعني ذلك عدم توفّر صفحات لاحقة.

MatchedUrl

هناك عنوان URL مطابق في رسالة Chat. يمكن لتطبيقات Chat معاينة عناوين URL المطابقة. لمزيد من المعلومات، يُرجى الاطّلاع على روابط المعاينة.

الحقول
url	string النتائج فقط. عنوان URL الذي تمت مطابقته

العضوية

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

الحقول
name	string اسم المورد الخاص بالاشتراك، الذي يحدّده الخادم التنسيق: spaces/{space}/members/{member}
state	MembershipState النتائج فقط. حالة الاشتراك
role	MembershipRole اختياريّ. دور المستخدم ضمن مساحة Chat، والذي يحدِّد الإجراءات المسموح بها في المساحة يمكن استخدام هذا الحقل كإدخال فقط في UpdateMembership.
create_time	Timestamp اختياريّ. غير قابل للتغيير وقت إنشاء العضوية، مثل وقت انضمام عضو إلى مساحة أو دعوته للانضمام إليها هذا الحقل ناتج فقط، إلا عند استخدامه لاستيراد الاشتراكات السابقة في مساحات وضع الاستيراد.
delete_time	Timestamp اختياريّ. غير قابل للتغيير. وقت حذف العضوية، مثل وقت مغادرة أحد الأعضاء للمساحة أو إزالته منها هذا الحقل ناتج فقط، إلا عند استخدامه لاستيراد الاشتراكات السابقة في مساحات وضع الاستيراد.
حقل الاتحاد memberType. العضو المرتبط بهذه العضوية قد تتوفّر أنواع أخرى من الاشتراكات في المستقبل. يمكن أن يكون memberType واحدًا فقط مما يلي:
member	User المستخدم أو التطبيق في Google Chat الذي يرتبط به الاشتراك. في حال تمت المصادقة كمستخدم في تطبيق Chat، ستتم تعبئة المستخدم name وtype.
group_member	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[]	MembershipCreatedEventData قائمة بالاشتراكات الجديدة

MembershipBatchDeletedEventData

الحمولة في الحدث لعدة عضويات تم حذفها

نوع الحدث: google.workspace.chat.membership.v1.batchDeleted

الحقول
memberships[]	MembershipDeletedEventData قائمة بالاشتراكات المحذوفة

MembershipBatchUpdatedEventData

الحمولة للحدث لاشتراكات متعدّدة معدَّلة

نوع الحدث: google.workspace.chat.membership.v1.batchUpdated

الحقول
memberships[]	MembershipUpdatedEventData قائمة بالاشتراكات المعدّلة

MembershipCreatedEventData

حمولة الأحداث لعضوية جديدة

نوع الفعالية: google.workspace.chat.membership.v1.created.

الحقول
membership	Membership العضوية الجديدة.

MembershipDeletedEventData

الحمولة في الحدث لاشتراك تم حذفه

نوع الحدث: google.workspace.chat.membership.v1.deleted

الحقول
membership	Membership العضوية المحذوفة تتم تعبئة الحقلين name وstate فقط.

MembershipUpdatedEventData

حمولة الحدث لعضوية معدّلة

نوع الحدث: google.workspace.chat.membership.v1.updated

الحقول
membership	Membership الاشتراك المعدّل

الرسالة

رسالة في مساحة Google Chat

الحقول
name	string اسم مورد الرسالة التنسيق: spaces/{space}/messages/{message} حيث يكون {space} هو معرّف المساحة التي تم نشر الرسالة فيها و{message} هو معرّف تحدّده النظام للرسالة. على سبيل المثال، spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB. في حال ضبط معرّف مخصّص عند إنشاء رسالة، يمكنك استخدام هذا المعرّف لتحديد الرسالة في الطلب من خلال استبدال {message} بالقيمة من الحقل clientAssignedMessageId. مثلاً: spaces/AAAAAAAAAAA/messages/client-custom-name لمعرفة التفاصيل، يُرجى الاطّلاع على تسمية رسالة.
sender	User النتائج فقط. المستخدم الذي أنشأ الرسالة. إذا كان تطبيق Chat يستخدم المصادقة كمستخدم، ستتم تعبئة المستخدِم name وtype في الإخراج.
create_time	Timestamp اختياريّ. غير قابل للتغيير بالنسبة إلى المساحات التي تم إنشاؤها في Chat، يشير ذلك إلى الوقت الذي تم فيه إنشاء الرسالة. هذا الحقل مخصّص للإخراج فقط، باستثناء استخدامه في مساحات وضع الاستيراد. بالنسبة إلى مساحات وضع الاستيراد، يجب ضبط هذا الحقل على الطابع الزمني السابق الذي تم إنشاء الرسالة فيه في المصدر للحفاظ على وقت الإنشاء الأصلي.
last_update_time	Timestamp النتائج فقط. الوقت الذي عدّل فيه أحد المستخدمين الرسالة آخر مرة وإذا لم يتم تعديل الرسالة من قبل، سيكون هذا الحقل فارغًا.
delete_time	Timestamp النتائج فقط. وقت حذف الرسالة في Google Chat إذا لم يتم حذف الرسالة مطلقًا، يكون هذا الحقل فارغًا.
text	string نص عادي للرسالة. ينشئ الرابط الأول لصورة أو فيديو أو صفحة ويب شريحة معاينة. يمكنك أيضًا الإشارة إلى مستخدم في Google Chat باستخدام @ أو الإشارة إلى جميع المستخدمين في المساحة. لمعرفة كيفية إنشاء الرسائل النصية، راجع إرسال رسالة.
formatted_text	string النتائج فقط. يحتوي على الرسالة text مع الترميزات المُضافة لتوصيل التنسيق. قد لا يتضمن هذا الحقل كل التنسيقات الظاهرة في واجهة المستخدم، ولكنه يتضمّن ما يلي: بنية الترميز للنص الغامق والمائل والمخطوط والنص ذي المسافة الثابتة والنص ذي المسافة الثابتة في شكل كتلة والقائمة النقطية يشير المستخدم إلى التطبيق باستخدام التنسيق <users/{user}>. روابط تشعّبية مخصّصة باستخدام التنسيق <{url}|{rendered_text}> حيث تكون السلسلة الأولى هي عنوان URL والثانية هي النص المعروض، على سبيل المثال، <http://example.com|custom text> رمز إيموجي مخصّص باستخدام التنسيق :{emoji_name}:، على سبيل المثال :smile: ولا ينطبق ذلك على الرموز التعبيرية بترميز يونيكود، مثل U+1F600 للرمز التعبيري للوجه المبتسم. للمزيد من المعلومات، يُرجى الاطّلاع على مقالة عرض تنسيق النص المُرسَل في رسالة.
cards[] (deprecated)	Card تم إيقاف هذا العنصر نهائيًا. متوقّفة نهائيًا: استخدِم cards_v2 بدلاً منها. بطاقات غنية ومنسّقة وتفاعلية يمكنك استخدامها لعرض عناصر واجهة المستخدم، مثل النصوص المنسّقة والأزرار والصور القابلة للنقر يتم عادةً عرض البطاقات أسفل نص الرسالة العادي. يمكن أن يصل حجم cards وcards_v2 إلى 32 كيلوبايت كحد أقصى.
cards_v2[]	CardWithId صفيف من البطاقات يمكن فقط لتطبيقات Chat إنشاء البطاقات. إذا كان تطبيق Chat يستخدم المصادقة كمستخدم، لا يمكن أن تحتوي الرسائل على بطاقات. لمعرفة كيفية إنشاء رسالة تحتوي على بطاقات، راجِع إرسال رسالة. تصميم البطاقات ومعاينتها باستخدام "أداة إنشاء البطاقات" فتح "أداة إنشاء البطاقات"
annotations[]	Annotation النتائج فقط. التعليقات التوضيحية المرتبطة بالرمز text في هذه الرسالة
thread	Thread سلسلة المحادثات التي تنتمي إليها الرسالة على سبيل المثال، يمكنك الاطّلاع على بدء سلسلة رسائل أو الرد عليها.
space	Space في حال تمت المصادقة كمستخدم لتطبيق Chat، تتم تعبئة المساحة name بالنتيجة.
fallback_text	string وصف بنص عادي لبطاقات الرسالة، يُستخدم عندما يتعذّر عرض البطاقات، مثل إشعارات الأجهزة الجوّالة.
action_response	ActionResponse الإدخال فقط. المَعلمات التي يمكن أن يستخدمها تطبيق Chat لضبط طريقة نشر ردّه
argument_text	string النتائج فقط. نص عادي للرسالة مع إزالة جميع الإشارات إلى تطبيقات Chat
slash_command	SlashCommand النتائج فقط. معلومات حول الأوامر التي تبدأ بشرطة مائلة، إن وُجدت
attachment[]	Attachment مرفق حمّله المستخدم
matched_url	MatchedUrl النتائج فقط. عنوان URL في spaces.messages.text يتطابق مع نمط معاينة رابط. لمزيد من المعلومات، يُرجى الاطّلاع على معاينة الروابط.
thread_reply	bool النتائج فقط. عندما يكون true، تكون الرسالة ردًا في سلسلة محادثات. عند false، تظهر الرسالة في المحادثة ذات المستوى الأعلى في المساحة إمّا كأول رسالة في سلسلة محادثات أو رسالة لا تتضمّن ردودًا في سلاسل محادثات. إذا كانت المساحة لا تتيح الرد في سلاسل المحادثات، سيكون هذا الحقل دائمًا false.
client_assigned_message_id	string اختياريّ. معرّف مخصّص للرسالة. يمكنك استخدام الحقل لتحديد رسالة أو الحصول على رسالة أو حذفها أو تعديلها. لإعداد معرّف مخصّص، حدِّد الحقل messageId عند إنشاء الرسالة. للحصول على التفاصيل، يُرجى الاطِّلاع على تسمية رسالة.
emoji_reaction_summaries[]	EmojiReactionSummary النتائج فقط. قائمة ملخّصات التفاعلات باستخدام الرموز التعبيرية على الرسالة
private_message_viewer	User غير قابل للتغيير. إدخال لإنشاء رسالة، وإلا تكون النتائج فقط. المستخدم الذي يمكنه عرض الرسالة. عند ضبط هذه السياسة، تكون الرسالة خاصة ولا تظهر إلا للمستخدم المحدّد وتطبيق Chat. لتضمين هذا الحقل في طلبك، عليك طلب واجهة برمجة تطبيقات Chat باستخدام مصادقة التطبيق وحذف ما يلي: المرفقات تطبيقات مصغّرة للملحقات لمعرفة التفاصيل، يُرجى الاطّلاع على إرسال رسالة بشكل خاص.
deletion_metadata	DeletionMetadata النتائج فقط. معلومات حول رسالة محذوفة يتم حذف الرسالة عند ضبط "delete_time".
quoted_message_metadata	QuotedMessageMetadata النتائج فقط. معلومات عن رسالة اقتبسها أحد مستخدمي Google Chat في مساحة يمكن لمستخدمي Google Chat اقتباس رسالة للرد عليها.
attached_gifs[]	AttachedGif النتائج فقط. صور GIF المرفقة بالرسالة
accessory_widgets[]	AccessoryWidget تطبيق مصغّر تفاعلي واحد أو أكثر يظهر في أسفل الرسالة يمكنك إضافة تطبيقات مصغّرة إلى الرسائل التي تتضمّن نصًا أو بطاقات أو نصًا وبطاقات معًا. لا تتوفَّر هذه الميزة للرسائل التي تحتوي على مربّعات حوار. لمعرفة التفاصيل، يُرجى الاطّلاع على إضافة تطبيقات مصغّرة تفاعلية في أسفل الرسالة. يتطلب إنشاء رسالة تتضمّن تطبيقات مصغّرة إضافية مصادقة التطبيق.

MessageBatchCreatedEventData

حمولة الحدث للرسائل الجديدة المتعددة

نوع الحدث: google.workspace.chat.message.v1.batchCreated

الحقول
messages[]	MessageCreatedEventData قائمة بالرسائل الجديدة

MessageBatchDeletedEventData

حمولة الحدث للرسائل المحذوفة المتعددة.

نوع الحدث: google.workspace.chat.message.v1.batchDeleted

الحقول
messages[]	MessageDeletedEventData قائمة بالرسائل المحذوفة

MessageBatchUpdatedEventData

الحمولة للحدث لعدة رسائل معدَّلة

نوع الحدث: google.workspace.chat.message.v1.batchUpdated

الحقول
messages[]	MessageUpdatedEventData قائمة بالرسائل المعدّلة

MessageCreatedEventData

حمولة الحدث لرسالة جديدة

نوع الحدث: google.workspace.chat.message.v1.created

الحقول
message	Message الرسالة الجديدة

MessageDeletedEventData

الحمولة لحدث رسالة محذوفة

نوع الحدث: google.workspace.chat.message.v1.deleted

الحقول
message	Message الرسالة المحذوفة. تتم تعبئة الحقول name وcreateTime وdeleteTime وdeletionMetadata فقط.

MessageUpdatedEventData

حمولة الحدث لرسالة معدَّلة

نوع الحدث: google.workspace.chat.message.v1.updated

الحقول
message	Message الرسالة المعدَّلة

QuotedMessageMetadata

معلومات حول رسالة مقتبسة

الحقول
name	string النتائج فقط. اسم مورد الرسالة المقتبَسة التنسيق: spaces/{space}/messages/{message}
last_update_time	Timestamp النتائج فقط. الطابع الزمني لوقت إنشاء الرسالة المقتبَسة أو وقت آخر تعديل للرسالة المُقتبَسة

فيديو يعرض ردود فعل

تفاعل مع رسالة

الحقول
name	string اسم مورد التفاعل. تنسيق الملف: spaces/{space}/messages/{message}/reactions/{reaction}
user	User النتائج فقط. المستخدم الذي أنشأ التفاعل
emoji	Emoji الرمز التعبيري المستخدَم في التفاعل

ReactionBatchCreatedEventData

الحمولة للحدث لتفاعلات جديدة متعددة

نوع الحدث: google.workspace.chat.reaction.v1.batchCreated

الحقول
reactions[]	ReactionCreatedEventData قائمة بالتفاعلات الجديدة

ReactionBatchDeletedEventData

الحمولة للحدث المتعلّقة بعدة تفاعلات محذوفة

نوع الحدث: google.workspace.chat.reaction.v1.batchDeleted

الحقول
reactions[]	ReactionDeletedEventData قائمة بالتفاعلات المحذوفة

ReactionCreatedEventData

حمولة الحدث لتفاعل جديد.

نوع الحدث: google.workspace.chat.reaction.v1.created

الحقول
reaction	Reaction التفاعل الجديد

ReactionDeletedEventData

الحمولة في الحدث لعملية حذف تفاعُل

النوع: google.workspace.chat.reaction.v1.deleted

الحقول
reaction	Reaction التفاعل المحذوف.

RichLinkMetadata

تمثّل هذه السمة رابطًا منسّقًا يؤدي إلى مرجع.

الحقول
uri	string معرّف الموارد المنتظم (URI) لهذا الرابط.
rich_link_type	RichLinkType نوع الرابط المنسّق.
حقل الربط data بيانات المرجع المرتبط يمكن أن يكون data واحدًا فقط مما يلي:
drive_link_data	DriveLinkData بيانات رابط Drive
chat_space_link_data	ChatSpaceLinkData بيانات رابط مساحة Chat

RichLinkType

نوع الرابط المزوّد بمحتوى إضافي ويمكن إضافة المزيد من الأنواع في المستقبل.

عمليات التعداد
RICH_LINK_TYPE_UNSPECIFIED	القيمة التلقائية للتعداد لا تستخدِم هذه الميزة.
DRIVE_FILE	نوع رابط منسّق في Google Drive
CHAT_SPACE	نوع من الروابط الغنية بصريًا لمساحات Chat. على سبيل المثال، شريحة ذكية لمكان

SearchSpacesRequest

طلب البحث عن قائمة بالمساحات استنادًا إلى طلب بحث

الحقول
use_admin_access	bool عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب هذا الحقل إما chat.admin.spaces.readonly أو chat.admin.spaces نطاق OAuth 2.0. لا تتيح هذه الطريقة حاليًا سوى إذن وصول المشرف، وبالتالي لا يتم قبول سوى true لهذا الحقل.
page_size	int32 الحد الأقصى لعدد المسافات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد المسافات، يتم عرض 100 مسافة كحد أقصى. الحد الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000.
page_token	string رمز مميّز تم تلقّيه من المكالمة السابقة لمساحات البحث قدِّم هذه المَعلمة لاسترداد الصفحة التالية. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة مع الطلب الذي قدّم رمز تعريف الصفحة. قد يؤدي تمرير قيم مختلفة إلى المعلَمات الأخرى إلى نتائج غير متوقعة.
query	string مطلوب. طلب بحث يمكنك البحث باستخدام المعلمات التالية: create_time customer display_name external_user_allowed last_active_time space_history_state space_type يقبل كل من create_time وlast_active_time طابعًا زمنيًا بتنسيق RFC-3339 وعوامل المقارنة المتوافقة هي: = و< و> و<= و>=. يجب إدخال customer، ويتم استخدامه للإشارة إلى العميل الذي سيتم جلب المساحات منه. customers/my_customer هي القيمة الوحيدة المسموح بها. لا يقبل display_name سوى عامل التشغيل HAS (:). يتم أولاً إنشاء رمز مميّز للنص المطلوب مطابقته على شكل رموز مميّزة، وتتم مطابقة كل رمز مميّز بشأن البادئة بشكل غير حسّاس لحالة الأحرف وبشكل مستقل كسلسلة فرعية في أي مكان في display_name للمساحة. على سبيل المثال، تتطابق السمة Fun Eve مع Fun event أو The evening was fun، ولكن لا تتطابق مع notFun event أو even. يقبل external_user_allowed إما true أو false. لا تقبل الدالة space_history_state إلا القيم من الحقل historyState في مورد space. السمة space_type مطلوبة والقيمة الصالحة الوحيدة هي SPACE. في الحقول المختلفة، يمكن استخدام AND عوامل تشغيل فقط. على سبيل المثال، space_type = "SPACE" AND display_name:"Hello" هو مثال صالح وspace_type = "SPACE" OR display_name:"Hello" هو مثال غير صالح. ضمن الحقل نفسه، لا يتوافق space_type مع عاملَي التشغيل AND أو OR. display_name و"space_history_state" و"external_user_allowed" تتوافق مع عوامل التشغيل OR فقط. تتوافق last_active_time وcreate_time مع عاملَي التشغيل AND وOR. لا يمكن استخدام AND إلا لتمثيل فاصل زمني، مثل last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00". نماذج طلبات البحث التالية صالحة: customer = "customers/my_customer" AND space_type = "SPACE" customer = "customers/my_customer" AND space_type = "SPACE" AND display_name:"Hello World" customer = "customers/my_customer" AND space_type = "SPACE" AND (last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time > "2022-01-01T00:00:00+00:00") customer = "customers/my_customer" AND space_type = "SPACE" AND (display_name:"Hello World" OR display_name:"Fun event") AND (last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time < "2022-01-01T00:00:00+00:00") customer = "customers/my_customer" AND space_type = "SPACE" AND (create_time > "2019-01-01T00:00:00+00:00" AND create_time < "2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND (space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")
order_by	string اختياريّ. كيفية ترتيب قائمة المساحات في ما يلي السمات المتوافقة للترتيب حسبها: membership_count.joined_direct_human_user_count — يشير إلى عدد المستخدمين الذين انضموا مباشرةً إلى مساحة. last_active_time: تشير إلى الوقت الذي تتم فيه إضافة آخر عنصر مؤهَّل إلى أي موضوع في هذه المساحة. create_time: يشير إلى وقت إنشاء المساحة. القيم الصالحة لعملية الطلب هي: ASC للترتيب التصاعدي. القيمة التلقائية DESC للترتيب التنازلي الصيغة المتوافقة هي: membership_count.joined_direct_human_user_count DESC membership_count.joined_direct_human_user_count ASC last_active_time DESC last_active_time ASC create_time DESC create_time ASC

SearchSpacesResponse

ردّ يتضمّن قائمة بالمساحات التي تتوافق مع طلب مساحات البحث

الحقول
spaces[]	Space صفحة للمساحات المطلوبة
next_page_token	string هو رمز مميّز يمكن استخدامه لاسترداد الصفحة التالية. إذا كان هذا الحقل فارغًا، يعني ذلك أنّه ما مِن صفحات لاحقة.
total_size	int32 إجمالي عدد المساحات التي تتطابق مع طلب البحث في جميع الصفحات إذا كانت النتيجة أكثر من 10,000 مسافة، تكون هذه القيمة تقديرية.

SetUpSpaceRequest

طلب إنشاء مساحة وإضافة مستخدمين محدّدين إليها

الحقول
space	Space مطلوب. يجب ملء الحقل Space.spaceType. لإنشاء مساحة، يجب ضبط Space.spaceType على SPACE وضبط Space.displayName. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS عند إعداد مساحة، جرِّب استخدام displayName آخر. قد تستخدم مساحة حالية في مؤسسة Google Workspace هذا الاسم المعروض. لإنشاء محادثة جماعية، اضبط Space.spaceType على GROUP_CHAT. لا تضبط Space.displayName. لإنشاء محادثة بين شخصين، اضبط Space.spaceType على DIRECT_MESSAGE واضبط Space.singleUserBotDm على false. لا تضبط القيمة على Space.displayName أو Space.spaceDetails. لإنشاء محادثة بين شخص وتطبيق Chat، اضبط Space.spaceType على DIRECT_MESSAGE وSpace.singleUserBotDm على true. لا تضبط السمة Space.displayName أو Space.spaceDetails. في حال توفُّر مساحة DIRECT_MESSAGE من قبل، سيتم عرض هذه المساحة بدلاً من إنشاء مساحة جديدة.
request_id	string اختياريّ. معرّف فريد لهذا الطلب. ننصحك باستخدام معرّف فريد عالمي (UUID) عشوائي. يؤدي تحديد معرّف طلب حالي إلى عرض المساحة التي تم إنشاؤها باستخدام هذا المعرّف بدلاً من إنشاء مساحة جديدة. يؤدي تحديد معرّف طلب حالي من تطبيق Chat نفسه مع مستخدم مختلف تمت مصادقته إلى عرض رسالة خطأ.
memberships[]	Membership اختياريّ. مستخدمو Google Chat أو المجموعات المطلوب دعوتها للانضمام إلى المساحة احذف اسم المستخدم المتصل لأنّه تتم إضافته تلقائيًا. تتيح هذه الميزة حاليًا إضافة ما يصل إلى 20 عضوية (بالإضافة إلى المتصل). بالنسبة إلى اشتراك المستخدم، يجب أن يحتوي الحقل Membership.member على user تمّت تعبئة name فيه (التنسيق: users/{user}) وتم ضبط type على User.Type.HUMAN. لا يمكنك إضافة مستخدمين إلا عند إعداد مساحة (لا تتوفّر إضافة تطبيقات Chat إلا لإعداد الرسائل المباشرة باستخدام تطبيق الاتصال). يمكنك أيضًا إضافة أعضاء باستخدام عنوان البريد الإلكتروني للمستخدم كعنوان بديل لـ {user}. على سبيل المثال، يمكن أن تكون السمة user.name هي users/[e-mail]. لدعوة مستخدمي Gmail أو مستخدمين من نطاقات Google Workspace خارجية، يجب استخدام عنوان البريد الإلكتروني للمستخدم في {user}. بالنسبة إلى عضوية مجموعة Google، يجب أن يحتوي الحقل Membership.group_member على group مع تعبئة name (بالتنسيق groups/{group}). لا يمكنك إضافة "مجموعات Google" إلا عند ضبط Space.spaceType على "SPACE". هذه السمة اختيارية عند ضبط Space.spaceType على SPACE. مطلوب عند ضبط Space.spaceType على GROUP_CHAT، بالإضافة إلى اشتراكَين على الأقل. مطلوب عند ضبط Space.spaceType على DIRECT_MESSAGE مع مستخدم بشري، بالإضافة إلى اشتراك واحد بالضبط. يجب أن يكون هذا الحقل فارغًا عند إنشاء محادثة بين مستخدم وتطبيق Chat الذي يجري الاتصال (عند ضبط Space.spaceType على DIRECT_MESSAGE وSpace.singleUserBotDm على true).

SlashCommand

أمر يبدأ بشرطة مائلة في Google Chat

الحقول
command_id	int64 تم استدعاء معرّف أمر الشرطة المائلة.

SlashCommandMetadata

البيانات الوصفية للتعليقات التوضيحية للأوامر التي تبدأ بشرطة مائلة (/)

الحقول
bot	User تطبيق Chat الذي تم استدعاء الأمر فيه
type	Type نوع أمر الشرطة المائلة.
command_name	string اسم أمر الشرطة المائلة الذي تمّ استدعاؤه
command_id	int64 رقم تعريف الأمر الذي يبدأ بشرطة مائلة والذي تمّ استدعاؤه.
triggers_dialog	bool يشير إلى ما إذا كان الأمر الذي يبدأ بشرطة مائلة مخصّصًا لمربّع حوار.

النوع

عمليات التعداد
TYPE_UNSPECIFIED	القيمة التلقائية للتعداد يُرجى عدم استخدامها.
ADD	أضِف تطبيق Chat إلى المساحة.
INVOKE	استدعاء أمر الشرطة المائلة في المساحة.

مسافة

مساحة في Google Chat المساحات هي محادثات بين مستخدمَين أو أكثر أو رسائل بين مستخدم وتطبيق Chat.

الحقول
name	string اسم المورد للمساحة. تنسيق الملف: spaces/{space} حيث يمثّل {space} رقم التعريف الذي حدّده النظام للمساحة. يمكنك الحصول على رقم تعريف المساحة من خلال استدعاء الطريقة spaces.list() أو من عنوان URL للمساحة. على سبيل المثال، إذا كان عنوان URL للمساحة هو https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA، يكون رقم تعريف المساحة هو AAAAAAAAA.
type (deprecated)	Type تم إيقاف هذا العنصر نهائيًا. النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام space_type بدلاً منها. نوع المساحة.
space_type	SpaceType نوع المساحة. مطلوبة عند إنشاء مساحة أو تعديل نوع المساحة النتائج فقط للاستخدامات الأخرى.
single_user_bot_dm	bool اختياريّ. ما إذا كانت المساحة عبارة عن رسالة مباشرة بين تطبيق Chat ومستخدم واحد
threaded (deprecated)	bool تم إيقاف هذا العنصر نهائيًا. النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام spaceThreadingState بدلاً منها. ما إذا كانت الرسائل مُدرَجة في سلسلة محادثات في هذه المساحة
display_name	string الاسم المعروض للمساحة. هذا الحقل مطلوب عند إنشاء مساحة باستخدام spaceType من SPACE. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS عند إنشاء مساحة أو تعديل displayName، يُرجى تجربة displayName آخر. قد تستخدم مساحة حالية في مؤسسة Google Workspace هذا الاسم المعروض. بالنسبة إلى الرسائل المباشرة، قد يكون هذا الحقل فارغًا. يمكن أن يتضمّن ما يصل إلى 128 حرفًا.
external_user_allowed	bool غير قابل للتغيير. ما إذا كانت هذه المساحة تسمح لأي مستخدم في Google Chat بأن يكون عضوًا فيها الإدخال عند إنشاء مساحة في مؤسسة Google Workspace احذف هذا الحقل عند إنشاء مساحات في الشروط التالية: يستخدم المستخدم الذي تمت مصادقته حساب مستهلك (حساب مستخدم غير مُدار). وفقًا للإعدادات التلقائية، تسمح المساحة التي يتم إنشاؤها من خلال حساب مستهلك لأي مستخدم في Google Chat. بالنسبة إلى المساحات الحالية، يكون هذا الحقل مخصّصًا للعرض فقط.
space_threading_state	SpaceThreadingState النتائج فقط. حالة سلسلة المحادثات في مساحة Chat
space_details	SpaceDetails تفاصيل حول المساحة بما في ذلك الوصف والقواعد.
space_history_state	HistoryState حالة سجلّ الرسائل للرسائل وسلاسل المحادثات في هذه المساحة
import_mode	bool اختياريّ. ما إذا تم إنشاء هذه المساحة في Import Mode كجزء من عملية نقل البيانات إلى Google Workspace. أثناء استيراد المساحات، لا تكون مرئية للمستخدمين إلى أن تكتمل عملية الاستيراد. يتطلب إنشاء مساحة في Import Mode مصادقة المستخدم.
create_time	Timestamp اختياريّ. غير قابل للتغيير. بالنسبة إلى المساحات التي تم إنشاؤها في Chat، يشير ذلك إلى وقت إنشاء المساحة. هذا الحقل هو الناتج فقط، إلا عند استخدامه في مساحات وضع الاستيراد. بالنسبة إلى المساحات في وضع الاستيراد، اضبط هذا الحقل على الطابع الزمني السابق الذي تم إنشاء المساحة به في المصدر للحفاظ على وقت الإنشاء الأصلي. لا تتم تعبئة هذا الحقل في الإخراج إلا عندما يكون spaceType هو GROUP_CHAT أو SPACE.
last_active_time	Timestamp النتائج فقط. الطابع الزمني لآخر رسالة في المساحة إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.
admin_installed	bool النتائج فقط. بالنسبة إلى مساحات الرسائل المباشرة التي تتضمّن تطبيق Chat، سواء أنشأها مشرف Google Workspace أم لا يمكن للمشرفين تثبيت رسالة مباشرة وإعدادها باستخدام تطبيق Chat نيابةً عن المستخدمين في مؤسستهم. لتفعيل ميزة "التثبيت من خلال المشرف"، يجب أن يتضمّن تطبيق Chat ميزة المراسلة المباشرة.
membership_count	MembershipCount النتائج فقط. يشير هذا المقياس إلى عدد العضويات في القناة مجمّعة حسب نوع العضوية. تتم تعبئة هذا الحقل عند ضبط space_type على SPACE أو DIRECT_MESSAGE أو GROUP_CHAT. معاينة المطوِّر: متاحة في إطار برنامج معاينة المطوّر على Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها.
access_settings	AccessSettings اختياريّ. تُحدِّد إعدادات الوصول إلى المساحة. لا تتم تعبئة هذا الحقل إلا عندما تكون قيمة space_type هي SPACE.
space_uri	string النتائج فقط. معرّف الموارد المتسلسل (URI) للمستخدم للوصول إلى المساحة
customer	string اختياريّ. غير قابل للتغيير. رقم تعريف العميل لنطاق المساحة لا يكون مطلوبًا إلا عند إنشاء مساحة باستخدام مصادقة التطبيق ويكون SpaceType هو SPACE، وإلا يجب عدم ضبطه. بالتنسيق customers/{customer}، حيث يشير customer إلى id من [مرجع العملاء في "SDK للمشرف"]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). يمكن للتطبيقات الخاصة أيضًا استخدام العنوان البديل للبريد الإلكتروني "customers/my_customer" لإنشاء المساحة في مؤسسة Google Workspace نفسها التي يستخدمها التطبيق. لا تتم تعبئة هذا الحقل في الرسائل المباشرة. إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.
حقل الربط space_permission_settings تمثّل إعدادات الأذونات لمساحة. لا تتم تعبئة هذا الحقل إلا عندما تكون قيمة space_type هي SPACE. يتطلب مصادقة المستخدم. يمكن أن يكون space_permission_settings واحدًا فقط مما يلي:
predefined_permission_settings	PredefinedPermissionSettings اختياريّ. الإدخال فقط إعدادات أذونات المساحة المحدَّدة مسبقًا: لا يتم الإدخال إلا عند إنشاء مساحة. في حال عدم ضبط الحقل، يتم إنشاء مساحة تعاون. بعد إنشاء المساحة، تتم تعبئة الإعدادات في الحقل PermissionSettings.
permission_settings	PermissionSettings اختياريّ. إعدادات أذونات المساحة للمساحات الحالية حقل لتعديل إعدادات أذونات المساحة بالضبط، حيث يتم استبدال إعدادات الأذونات الحالية قوائم الإخراج إعدادات الأذونات الحالية

AccessSettings

يمثل هذا الإعداد إعدادات الوصول للمساحة.

الحقول
access_state	AccessState النتائج فقط. يشير إلى حالة الوصول إلى المساحة.
audience	string اختياريّ. اسم المرجع للجمهور المستهدَف الذي يمكنه اكتشاف المساحة والانضمام إليها ومعاينة الرسائل فيها. في حال عدم ضبط الإعداد، لن يتمكّن من الوصول إلى المساحة سوى المستخدمين أو "مجموعات Google" الذين تمت دعوتهم أو إضافتهم إلى المساحة بشكل فردي. لمعرفة التفاصيل، يُرجى الاطّلاع على إتاحة مساحة للاكتشاف من قِبل جمهور مستهدف. التنسيق: audiences/{audience} لاستخدام الجمهور المستهدف التلقائي لمؤسسة Google Workspace، اضبط القيمة على audiences/default. تتيح قراءة الجمهور المستهدَف ما يلي: مصادقة المستخدم مصادقة التطبيق مع موافقة المشرف باستخدام النطاق chat.app.spaces في إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. لا يتمّ ملء هذا الحقل عند استخدام نطاق chat.bot مع مصادقة التطبيق. يتطلب ضبط الجمهور المستهدَف مصادقة المستخدِم.

AccessState

يمثّل حالة الوصول إلى المساحة.

عمليات التعداد
ACCESS_STATE_UNSPECIFIED	حالة الوصول غير معروفة أو غير متاحة في واجهة برمجة التطبيقات هذه.
PRIVATE	يمكن فقط للمستخدمين أو "مجموعات Google" التي أضافها مستخدمون آخرون أو أرسلوا دعوة إليها بشكل فردي أو مشرفي Google Workspace اكتشاف المساحة والوصول إليها.
DISCOVERABLE	منح مدير المساحة جمهورًا مستهدفًا الإذن بالوصول إلى المساحة. يمكن أيضًا للمستخدمين أو "مجموعات Google" الذين تمت إضافتهم أو دعوتهم بشكل فردي إلى المساحة اكتشاف المساحة والوصول إليها. لمزيد من المعلومات، يُرجى الاطّلاع على إتاحة العثور على مساحة لمستخدمين محدّدين. يتطلّب إنشاء مساحات قابلة للاكتشاف مصادقة المستخدم.

MembershipCount

يمثل هذا العدد عدد العضويات في مساحة، مجمَّعة ضمن فئات.

الحقول
joined_direct_human_user_count	int32 عدد المستخدمين الذين انضموا إلى المساحة مباشرةً، بدون احتساب المستخدمين الذين انضموا من خلال عضوية في مجموعة.
joined_group_count	int32 عدد جميع المجموعات التي انضمت إلى المساحة مباشرةً

PermissionSetting

يمثّل إعداد إذن مساحة.

الحقول
managers_allowed	bool ما إذا كان مدراء المساحات لديهم هذا الإذن
members_allowed	bool ما إذا كان الأعضاء غير الإداريين لديهم هذا الإذن أم لا.

PermissionSettings

إعدادات الأذونات التي يمكنك تحديدها عند تعديل مساحة حالية مُسمّاة

لضبط إعدادات الأذونات عند إنشاء مساحة، حدِّد حقل PredefinedPermissionSettings في طلبك.

الحقول
manage_members_and_groups	PermissionSetting إعداد لإدارة الأعضاء والمجموعات في مساحة.
modify_space_details	PermissionSetting إعدادات لتعديل اسم المساحة وصورتها الرمزية ووصفها وإرشاداتها
toggle_history	PermissionSetting إعداد للتبديل بين تفعيل سجلّ المساحات وإيقافه.
use_at_mention_all	PermissionSetting إعدادات استخدام @all في مساحة
manage_apps	PermissionSetting إعداد لإدارة التطبيقات في مساحة
manage_webhooks	PermissionSetting إعداد لإدارة روابط الردّ التلقائي على الويب في مساحة
post_messages	PermissionSetting النتائج فقط. خيار لنشر الرسائل في مساحة
reply_messages	PermissionSetting إعداد للرد على الرسائل في مساحة

PredefinedPermissionSettings

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

عمليات التعداد
PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED	غير محدد لا تستخدِم هذه الميزة.
COLLABORATION_SPACE	إعداد لجعل المساحة مساحة تعاون يمكن لجميع الأعضاء نشر الرسائل فيها
ANNOUNCEMENT_SPACE	إعداد لجعل المساحة مساحة إعلانية حيث يمكن فقط لمدراء المساحة نشر الرسائل

SpaceDetails

تفاصيل عن المساحة، بما في ذلك الوصف والقواعد

الحقول
description	string اختياريّ. وصف للمساحة على سبيل المثال، يمكنك وصف موضوع المناقشة في المساحة أو الغرض الوظيفي منها أو المشاركين فيها. يمكن استخدام أكثر من 150 حرفًا.
guidelines	string اختياريّ. قواعد المساحة وتوقعاتها وآدابها يمكن إدخال ما يصل إلى 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[]	SpaceUpdatedEventData قائمة بالمساحات المعدَّلة

SpaceEvent

حدث يمثّل تغييرًا أو نشاطًا في مساحة Google Chat لمزيد من المعلومات، راجِع مقالة العمل مع الأحداث من Google Chat.

الحقول
name	string اسم مورد الحدث في المساحة تنسيق الملف: spaces/{space}/spaceEvents/{spaceEvent}
event_time	Timestamp وقت وقوع الحدث
event_type	string نوع حدث المساحة يحتوي كل نوع من أنواع الأحداث على نسخة مجمّعة تمثّل تكرارات متعددة من نوع الحدث الذي يقع في فترة زمنية قصيرة. بالنسبة إلى طلبات spaceEvents.list()، احذف أنواع الأحداث المجمّعة في فلتر طلبات البحث. يعرض الخادم تلقائيًا نوع الحدث ونسخته المجمّعة. أنواع الأحداث المتوافقة مع الرسائل: رسالة جديدة: google.workspace.chat.message.v1.created الرسالة المعدَّلة: google.workspace.chat.message.v1.updated رسالة محذوفة: google.workspace.chat.message.v1.deleted رسائل جديدة متعددة: google.workspace.chat.message.v1.batchCreated رسائل مُعدَّلة متعددة: google.workspace.chat.message.v1.batchUpdated رسائل محذوفة متعددة: google.workspace.chat.message.v1.batchDeleted أنواع الأحداث المتوافقة مع الاشتراكات: عضوية جديدة: google.workspace.chat.membership.v1.created العضوية المعدَّلة: google.workspace.chat.membership.v1.updated العضوية المحذوفة: google.workspace.chat.membership.v1.deleted اشتراكات جديدة متعددة: google.workspace.chat.membership.v1.batchCreated عضويات متعدّدة تم تعديلها: google.workspace.chat.membership.v1.batchUpdated عدة عضويات محذوفة: google.workspace.chat.membership.v1.batchDeleted أنواع الأحداث المتوافقة للتفاعلات: تفاعل جديد: google.workspace.chat.reaction.v1.created التفاعل المحذوف: google.workspace.chat.reaction.v1.deleted تفاعلات متعددة جديدة: google.workspace.chat.reaction.v1.batchCreated تفاعلات متعدّدة محذوفة: google.workspace.chat.reaction.v1.batchDeleted أنواع الأحداث المتوافقة حول المساحة: المساحة المعدَّلة: google.workspace.chat.space.v1.updated تعديلات متعددة على المساحة: google.workspace.chat.space.v1.batchUpdated
حقل الاتحاد payload. يمكن أن يكون payload واحدًا فقط مما يلي:
message_created_event_data	MessageCreatedEventData حمولة الحدث لرسالة جديدة نوع الحدث: google.workspace.chat.message.v1.created
message_updated_event_data	MessageUpdatedEventData الحمولة للحدث لرسالة معدَّلة. نوع الحدث: google.workspace.chat.message.v1.updated
message_deleted_event_data	MessageDeletedEventData الحمولة لحدث رسالة محذوفة نوع الحدث: google.workspace.chat.message.v1.deleted
message_batch_created_event_data	MessageBatchCreatedEventData الحمولة للحدث لعدة رسائل جديدة نوع الحدث: google.workspace.chat.message.v1.batchCreated
message_batch_updated_event_data	MessageBatchUpdatedEventData حمولة الحدث لعدة رسائل تم تعديلها. نوع الحدث: google.workspace.chat.message.v1.batchUpdated
message_batch_deleted_event_data	MessageBatchDeletedEventData حمولة الحدث للرسائل المحذوفة المتعددة. نوع الحدث: google.workspace.chat.message.v1.batchDeleted
space_updated_event_data	SpaceUpdatedEventData حمولة الأحداث لتعديل المساحة نوع الحدث: google.workspace.chat.space.v1.updated
space_batch_updated_event_data	SpaceBatchUpdatedEventData الحمولة للحدث لإجراء تعديلات متعدّدة على مساحة نوع الحدث: google.workspace.chat.space.v1.batchUpdated
membership_created_event_data	MembershipCreatedEventData الحمولة البرمجية للحدث لاشتراك جديد. نوع الحدث: google.workspace.chat.membership.v1.created
membership_updated_event_data	MembershipUpdatedEventData حمولة الحدث لعضوية معدّلة نوع الحدث: google.workspace.chat.membership.v1.updated
membership_deleted_event_data	MembershipDeletedEventData حمولة الحدث لعضوية محذوفة. نوع الحدث: google.workspace.chat.membership.v1.deleted
membership_batch_created_event_data	MembershipBatchCreatedEventData حمولة الأحداث لعدة عضويات جديدة نوع الحدث: google.workspace.chat.membership.v1.batchCreated
membership_batch_updated_event_data	MembershipBatchUpdatedEventData حمولة الأحداث لعدة عضويات تم تعديلها. نوع الحدث: google.workspace.chat.membership.v1.batchUpdated
membership_batch_deleted_event_data	MembershipBatchDeletedEventData حمولة الأحداث لعدة عضويات محذوفة. نوع الحدث: google.workspace.chat.membership.v1.batchDeleted
reaction_created_event_data	ReactionCreatedEventData حمولة الحدث لتفاعل جديد. نوع الحدث: google.workspace.chat.reaction.v1.created
reaction_deleted_event_data	ReactionDeletedEventData حمولة الحدث لتفاعل محذوف. نوع الحدث: google.workspace.chat.reaction.v1.deleted
reaction_batch_created_event_data	ReactionBatchCreatedEventData حمولة الأحداث لتفاعلات جديدة متعددة. نوع الحدث: google.workspace.chat.reaction.v1.batchCreated
reaction_batch_deleted_event_data	ReactionBatchDeletedEventData الحمولة للحدث لعدة تفاعلات محذوفة نوع الحدث: google.workspace.chat.reaction.v1.batchDeleted

SpaceReadState

حالة قراءة المستخدم ضمن مساحة، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة.

الحقول
name	string اسم المورد لحالة القراءة في المساحة التنسيق: users/{user}/spaces/{space}/spaceReadState
last_read_time	Timestamp اختياريّ. الوقت الذي تم فيه تعديل حالة قراءة المستخدم للمساحة وعادةً ما يتوافق هذا مع الطابع الزمني لآخر رسالة مقروءة أو طابع زمني يحدّده المستخدم لوضع علامة على آخر موضع قراءة في إحدى المساحات.

SpaceUpdatedEventData

حمولة الأحداث في مساحة محدَّثة

نوع الحدث: google.workspace.chat.space.v1.updated

الحقول
space	Space المساحة المعدَّلة

Thread

سلسلة محادثات في مساحة Google Chat للاطّلاع على أمثلة على الاستخدام، يُرجى الاطّلاع على بدء سلسلة محادثات أو الردّ عليها.

إذا حدّدت سلسلة محادثات عند إنشاء رسالة، يمكنك ضبط الحقل messageReplyOption لتحديد ما يحدث في حال عدم العثور على سلسلة محادثات مطابقة.

الحقول
name	string اسم المورد الخاص بالسلسلة مثلاً: spaces/{space}/threads/{thread}
thread_key	string اختياريّ. إدخال لإنشاء سلسلة محادثات أو تعديلها في الحالات الأخرى، يتم عرض الناتج فقط. رقم تعريف سلسلة المحادثات يمكن استخدام ما يصل إلى 4,000 حرف. هذا المعرّف فريد لتطبيق Chat الذي يضبطه. على سبيل المثال، إذا أنشأت تطبيقات محادثة متعددة رسالة باستخدام مفتاح سلسلة المحادثات نفسه، يتم نشر الرسائل في سلاسل محادثات مختلفة. للرد في سلسلة محادثات أنشأها مستخدم أو تطبيق آخر في Chat، حدِّد حقل سلسلة المحادثات name بدلاً من ذلك.

ThreadReadState

حالة قراءة المستخدم ضمن سلسلة محادثات، تُستخدَم لتحديد الرسائل المقروءة وغير المقروءة.

الحقول
name	string اسم المورد لحالة قراءة سلسلة المحادثات تنسيق الملف: users/{user}/spaces/{space}/threads/{thread}/threadReadState
last_read_time	Timestamp الوقت الذي تم فيه تعديل حالة قراءة المستخدم للمحادثة يتجاوب هذا عادةً مع الطابع الزمني لآخر رسالة مقروءة في سلسلة المحادثات.

UpdateMembershipRequest

رسالة طلب لتعديل اشتراك

الحقول
membership	Membership مطلوب. الاشتراك المطلوب تعديله لا يتم تعديل سوى الحقول المحدّدة بواسطة update_mask.
update_mask	FieldMask مطلوب. مسارات الحقول التي سيتم تعديلها افصل بين القيم المتعدّدة بفواصل أو استخدِم * لتعديل جميع مسارات الحقول. مسارات الحقول المتوافقة حاليًا: role
use_admin_access	bool عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب نطاق OAuth 2.0 chat.admin.memberships.

UpdateMessageRequest

طلب تعديل رسالة

الحقول
message	Message مطلوب. رسالة تم تعديل الحقول فيها
update_mask	FieldMask مطلوب. مسارات الحقول التي سيتم تعديلها افصل بين القيم المتعدّدة بفواصل أو استخدِم * لتعديل جميع مسارات الحقول. مسارات الحقول المتوافقة حاليًا: text attachment cards (يتطلب مصادقة التطبيق) cards_v2 (يتطلب مصادقة التطبيق) accessory_widgets (يتطلب مصادقة التطبيق)
allow_missing	bool اختياريّ. في حال عدم العثور على true والرسالة، يتم إنشاء رسالة جديدة ويتم تجاهل updateMask. يجب أن يكون معرّف الرسالة المحدّد client-assigned وإلا سيتعذّر تنفيذ الطلب.

UpdateSpaceReadStateRequest

طلب رسالة لواجهة برمجة تطبيقات UpdateSpaceReadState.

الحقول
space_read_state	SpaceReadState مطلوب. حالة قراءة المساحة والحقول المطلوب تعديلها. لا تتوافق هذه الميزة إلا مع تعديل حالة القراءة للمستخدم المتصل. للإشارة إلى المستخدم الذي يتصل بتطبيقك، عليك ضبط أحد الخيارات التالية: الاسم المستعار me مثلاً: users/me/spaces/{space}/spaceReadState عنوان بريده الإلكتروني على Workspace. مثلاً: users/[e-mail]/spaces/{space}/spaceReadState رقم تعريف المستخدم مثلاً: users/123456789/spaces/{space}/spaceReadState التنسيق: users/{user}/spaces/{space}/spaceReadState
update_mask	FieldMask مطلوب. مسارات الحقول المطلوب تعديلها. مسارات الحقول المتوافقة حاليًا: last_read_time عندما يكون last_read_time قبل وقت إنشاء آخر رسالة، تظهر المساحة على أنّها غير مقروءة في واجهة المستخدم. لوضع علامة "تمت القراءة" على المساحة، اضبط last_read_time على أي قيمة لاحقة (أكبر) من وقت إنشاء آخر رسالة. تم فرض قيمة last_read_time لمطابقة أحدث وقت لإنشاء الرسالة. يُرجى ملاحظة أنّ حالة قراءة المساحة تؤثر فقط في حالة قراءة الرسائل التي تظهر في المحادثة ذات المستوى الأعلى في المساحة. ولا تتأثّر الردود في سلاسل المحادثات بهذا الطابع الزمني، بل تعتمد على حالة قراءة سلسلة المحادثات بدلاً من ذلك.

UpdateSpaceRequest

طلب لتعديل مساحة واحدة

الحقول
space	Space مطلوب. مساحة تحتوي على حقول ستتمّ مراجعتها يجب تعبئة Space.name على شكل spaces/{space}. يتم تعديل الحقول التي يحدِّدها update_mask فقط.
update_mask	FieldMask مطلوب. مسارات الحقول المعدَّلة، مفصولة بفواصل إذا كانت هناك عدة مسارات. يمكنك تعديل الحقول التالية للمساحة: space_details: لتعديل وصف المساحة يمكن استخدام أكثر من 150 حرفًا. display_name: لا تتيح هذه القيمة تعديل الاسم المعروض إلا للمساحات التي يكون فيها الحقل spaceType هو SPACE. إذا ظهرت لك رسالة الخطأ ALREADY_EXISTS، جرِّب قيمة مختلفة. قد تستخدم مساحة حالية في مؤسسة Google Workspace هذا الاسم المعروض. space_type: لا تتيح سوى تغيير نوع مساحة GROUP_CHAT إلى SPACE. يُرجى تضمين display_name مع space_type في قناع التحديث والتأكّد من أنّ المساحة المحدّدة لها اسم معروض غير فارغ ونوع المساحة SPACE. إنّ تضمين القناع space_type والنوع SPACE في المساحة المحدّدة عند تعديل الاسم المعروض هو إجراء اختياري إذا كانت المساحة الحالية من النوع SPACE. تؤدي محاولة تعديل نوع المساحة بطرق أخرى إلى ظهور خطأ وسيطة غير صالح. لا يمكن استخدام space_type مع useAdminAccess. space_history_state: تعديل إعدادات سجلّ المساحة من خلال تفعيل السجلّ أو إيقافه للمساحة لا يتوفّر هذا الخيار إلا إذا كانت إعدادات السجلّ مفعّلة لمؤسسة Google Workspace. لتعديل حالة سجلّ المساحة، يجب حذف جميع أقنعة الحقول الأخرى في طلبك. لا يمكن استخدام space_history_state مع useAdminAccess. ‫access_settings.audience: تعديل إعدادات الوصول إلى المستخدمين الذين يمكنهم اكتشاف المساحة والانضمام إليها ومعاينة الرسائل في المساحة المُسمّاة التي يكون فيها الحقل spaceType هو SPACE إذا كانت المساحة الحالية تتضمّن جمهورًا مستهدفًا، يمكنك إزالة الجمهور وحصر الوصول إلى المساحة من خلال حذف قيمة لقناع الحقل هذا. لتعديل إعدادات الوصول إلى مساحة معيّنة، يجب أن يكون المستخدم الذي يتولى المصادقة هو مدير مساحة وأن يحذف جميع أقنعة الحقول الأخرى في طلبك. لا يمكنك تعديل هذا الحقل إذا كانت المساحة في وضع الاستيراد. لمزيد من المعلومات، يُرجى الاطّلاع على إتاحة العثور على مساحة لمستخدمين محدّدين. لا يمكن استخدام access_settings.audience مع useAdminAccess. permission_settings: يتيح تغيير إعدادات الأذونات للمساحة. عند تعديل إعدادات الأذونات، يمكنك تحديد أقنعة حقول permissionSettings فقط، ولا يمكنك تعديل أقنعة حقول أخرى في الوقت نفسه. لا يمكن استخدام permissionSettings مع useAdminAccess. تشمل أقنعة الحقول المتوافقة ما يلي: permission_settings.manageMembersAndGroups permission_settings.modifySpaceDetails permission_settings.toggleHistory permission_settings.useAtMentionAll permission_settings.manageApps permission_settings.manageWebhooks permission_settings.replyMessages
use_admin_access	bool عند true، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace للمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". تتطلّب هذه الوظيفة chat.admin.spaces نطاق OAuth 2.0. لا تتوفّر بعض قيم FieldMask باستخدام إذن الوصول الخاص بالمشرف. لمعرفة التفاصيل، يُرجى الاطّلاع على وصف update_mask.

مستخدم

مستخدم في Google Chat عند عرض نتيجة من طلب، في حال تمت المصادقة كمستخدم في تطبيق Chat، لا تتم تعبئة نتائج مورد User إلا name وtype للمستخدم.

الحقول
name	string اسم المورد لـ user في Google Chat. التنسيق: users/{user} يمكن استخدام users/app كاسم بديل لمستخدم تطبيق الاتصال bot. بالنسبة إلى human users، يكون {user} هو معرّف المستخدم نفسه في ما يلي: ‫id لعنصر المستخدم في People API على سبيل المثال، يمثّل users/123456789 في Chat API المستخدم نفسه الذي يمثّله 123456789 رقم تعريف الملف الشخصي للمستخدم في People API. id لـ مستخدم في Admin SDK Directory API يمكن استخدام عنوان البريد الإلكتروني الخاص بالمستخدم كعنوان بديل للبريد الإلكتروني {user} في طلبات البيانات من واجهة برمجة التطبيقات. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي لمستخدم [e-mail] في People API هو 123456789، يمكنك استخدام users/[e-mail] كاسم بديل للإشارة إلى users/123456789. ولن يتم عرض سوى اسم المورد الأساسي (على سبيل المثال users/123456789) من واجهة برمجة التطبيقات.
display_name	string النتائج فقط. الاسم المعروض للمستخدم
domain_id	string المعرّف الفريد لنطاق Google Workspace الخاص بالمستخدم
type	Type نوع المستخدم
is_anonymous	bool النتائج فقط. عند true، يتم حذف المستخدم أو لا يكون ملفه الشخصي مرئيًا.

النوع

عمليات التعداد
TYPE_UNSPECIFIED	القيمة التلقائية لقائمة القيم المحدّدة يُرجى عدم استخدامها.
HUMAN	مستخدم بشري
BOT	مستخدم تطبيق Chat

UserMentionMetadata

البيانات الوصفية للتعليقات التوضيحية لإشارات المستخدمين (@)

الحقول
user	User المستخدم المُشار إليه
type	Type نوع إشارة المستخدم

النوع

عمليات التعداد
TYPE_UNSPECIFIED	القيمة التلقائية للتعداد لا تستخدِم هذه الميزة.
ADD	إضافة مستخدم إلى المساحة
MENTION	الإشارة إلى مستخدم في المساحة

WidgetMarkup

الأداة هي عنصر في واجهة المستخدم يعرض النصوص والصور.

الحقول
buttons[]	Button قائمة بالأزرار Buttons هي أيضًا oneof data ويجب ضبط حقل واحد فقط من هذه الحقول.
حقل الاتحاد data. لا يمكن أن يتضمّن WidgetMarkup سوى أحد العناصر التالية. يمكنك استخدام حقول WidgetMarkup متعددة لعرض المزيد من العناصر. يمكن أن يكون data واحدًا فقط مما يلي:
text_paragraph	TextParagraph عرض فقرة نصية في هذه الأداة المصغّرة
image	Image يمكنك عرض صورة في هذا التطبيق المصغّر.
key_value	KeyValue عرض عنصر قيمة رئيسي في هذا التطبيق المصغّر

زرّ

زر يمكن أن يكون زرًا نصيًا أو زرًا مزوّدًا بصورة.

الحقول
حقل الاتحاد type. يمكن أن يكون type واحدًا فقط مما يلي:
text_button	TextButton زر يحتوي على نص وإجراء onclick.
image_button	ImageButton زر مع صورة وإجراء onclick.

FormAction

يصف إجراء النموذج السلوك عند إرسال النموذج. على سبيل المثال، يمكنك استدعاء "برمجة تطبيقات Google" للتعامل مع النموذج.

الحقول
action_method_name	string يتم استخدام اسم الطريقة لتحديد أي جزء من النموذج أدّى إلى إرسال النموذج. تتم إعادة هذه المعلومات إلى تطبيق Chat كجزء من حدث النقر على البطاقة. يمكنك استخدام اسم الطريقة نفسه لعدة عناصر تؤدي إلى سلوك شائع.
parameters[]	ActionParameter قائمة مَعلمات الإجراء

ActionParameter

قائمة بمَعلمات السلاسل التي يجب تقديمها عند استدعاء طريقة الإجراء على سبيل المثال، يمكنك التفكير في ثلاثة أزرار للتأجيل الآن، وتأجيل يوم واحد، وتأجيل من الأسبوع القادم. يمكنك استخدام action method = snooze()، مع تمرير نوع الغفوة ووقت الغفوة في قائمة مَعلمات السلاسل.

الحقول
key	string اسم مَعلمة النص البرمجي للإجراء.
value	string قيمة المَعلمة

الرمز

مجموعة الرموز المتوافقة

عمليات التعداد
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	string عنوان URL للصورة
on_click	OnClick إجراء onclick.
aspect_ratio	double نسبة العرض إلى الارتفاع لهذه الصورة (العرض والارتفاع) يتيح لك هذا الحقل حجز الارتفاع المناسب للصورة أثناء انتظار تحميلها. ولا يهدف إلى إلغاء نسبة العرض إلى الارتفاع المضمّنة في الصورة. في حال عدم ضبطها، سيملؤها الخادم من خلال التحميل المُسبَق للصورة.

ImageButton

زر صورة يتضمّن إجراءً onclick

الحقول
on_click	OnClick إجراء onclick.
name	string اسم image_button هذا المستخدَم لتسهيل الاستخدام يتم توفير القيمة التلقائية في حال عدم تحديد هذا الاسم.
حقل الربط icons يمكن تحديد الرمز باستخدام Icon enum أو عنوان URL. يمكن أن يكون icons واحدًا فقط مما يلي:
icon	Icon يشير ذلك المصطلح إلى الرمز المحدَّد من خلال enum ويفهرس الرمز المتوفّر من خلال Chat API.
icon_url	string الرمز المحدّد من خلال عنوان URL

KeyValue

يحتوي عنصر واجهة المستخدم على مفتاح (تسمية) وقيمة (محتوى). يمكن أن يحتوي هذا العنصر أيضًا على بعض الإجراءات مثل الزر onclick.

الحقول
top_label	string نص التصنيف العلوي يمكن استخدام النص المنسَّق. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace.
content	string نص المحتوى يجب استخدام نص منسّق في كل الأوقات. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace.
content_multiline	bool إذا كان المحتوى يجب أن يكون متعدّد الأسطر
bottom_label	string نص التصنيف السفلي. النص المنسّق مسموح به. لمزيد من المعلومات عن تنسيق النص، يُرجى الاطّلاع على المقالتَين تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace.
on_click	OnClick إجراء onclick. لا يمكن النقر إلا على التصنيف العلوي والتصنيف السفلي ومنطقة المحتوى.
حقل الاتحاد icons. يجب تحديد رمز واحد على الأقل من top_label وbottom_label. يمكن أن يكون icons واحدًا فقط مما يلي:
icon	Icon يشير ذلك المصطلح إلى قيمة تعداد يتم استبدالها في Chat API بصورة الرمز المقابلة.
icon_url	string الرمز المحدّد من خلال عنوان URL
حقل الاتحاد control. تطبيق مصغّر للتحكّم يمكنك ضبط button أو switch_widget، ولكن ليس كليهما. يمكن أن يكون control واحدًا فقط مما يلي:
button	Button زر يمكن النقر عليه لبدء إجراء

OnClick

إجراء onclick (مثل فتح رابط)

الحقول
حقل الربط data يمكن أن يكون data واحدًا فقط مما يلي:
action	FormAction يتم تشغيل إجراء النموذج من خلال إجراء onclick هذا في حال تحديده.
open_link	OpenLink يؤدي إجراء onclick هذا إلى تشغيل إجراء فتح الرابط في حال تحديده.

OpenLink

رابط يفتح نافذة جديدة

الحقول
url	string عنوان URL المطلوب فتحه.

TextButton

زر يحتوي على نص وإجراء onclick

الحقول
text	string النص المكتوب على الزر.
on_click	OnClick إجراء onclick للزر

TextParagraph

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

الحقول
text	string