Package google.chat.v1

الفهرس

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)

تنشئ رمزًا تعبيريًا مخصّصًا.

يتطلب مصادقة المستخدم.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/chat.customemojis

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Membership)

ينشئ اشتراكًا لتطبيق Chat المخصّص للمكالمات أو مستخدم أو مجموعة على 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)

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

يتطلب مصادقة المستخدم.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/chat.customemojis

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Membership)

يؤدي هذا الإجراء إلى حذف الاشتراك. على سبيل المثال، راجِع إزالة مستخدم أو تطبيق 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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
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)

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

توفّر الأنواع التالية من المصادقة:

نطاقات الأذونات

يتطلب أحد نطاقات 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)

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

يتطلب مصادقة المستخدم.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/chat.customemojis

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

عرض تفاصيل حول اشتراك على سبيل المثال، اطّلِع على الحصول على تفاصيل حول اشتراك مستخدم أو تطبيق Google Chat.

توفّر الأنواع التالية من المصادقة:

نطاقات الأذونات

يتطلب أحد نطاقات 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)

عرض تفاصيل عن مساحة على سبيل المثال، يُرجى الاطّلاع على الحصول على تفاصيل عن مساحة.

تتوافق مع أنواع المصادقة التالية:

نطاقات التفويض

يتطلب أحد نطاقات 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)

يتم إدراج الرموز التعبيرية المخصصة المرئية للمستخدم الذي تمت مصادقته.

يتطلب مصادقة المستخدم.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/chat.customemojis

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

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

تتوافق مع أنواع المصادقة التالية:

نطاقات التفويض

يتطلب هذا الإعداد أحد نطاقات 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. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي للمستخدم user@example.com في People API هو 123456789، يمكنك إضافة المستخدم إلى المساحة من خلال ضبط membership.member.name على users/user@example.com أو users/123456789.

لتحديد مجموعات Google المطلوب إضافتها، أضِف العضويات باستخدام الرمز membership.group_member.name المناسب. لإضافة مجموعة Google أو دعوتها، استخدِم groups/{group}، حيث يكون {group} هو id للمجموعة من Cloud Identity Groups API. على سبيل المثال، يمكنك استخدام Cloud Identity Groups lookup API لاسترداد المعرّف 123456789 لعنوان البريد الإلكتروني للمجموعة group@example.com، ثم يمكنك إضافة المجموعة إلى المساحة من خلال ضبط 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)

تعديل اشتراك للحصول على مثال، اطّلِع على تعديل عضوية مستخدم في مساحة.

تتوافق مع أنواع المصادقة التالية:

نطاقات الأذونات

يتطلب أحد نطاقات 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 هذا الاسم المعروض.

تتوافق مع أنواع المصادقة التالية:

نطاقات الأذونات

يتطلب أحد نطاقات 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

البيانات الوصفية لأمر الشرطة المائلة.

AnnotationType

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

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

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

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

الحقول
custom_emoji

CustomEmoji

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

CreateMembershipRequest

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

الحقول
parent

string

مطلوب. اسم المورد للمساحة التي تريد إنشاء الاشتراك لها.

التنسيق: spaces/{space}
membership

Membership

مطلوب. علاقة الاشتراك المطلوب إنشاؤها.

يجب أن يحتوي الحقل memberType على مستخدِم تمت تعبئة الحقلَين user.name وuser.type فيه. سيحدّد الخادم اسمًا للمورد وسيؤدّي ذلك إلى استبدال أيّ شيء محدّد.

عندما ينشئ تطبيق Chat علاقة عضوية لمستخدم بشري، يجب أن يستخدم نطاقات تفويض معيّنة ويضبط قيمًا معيّنة لحقول معيّنة:

  • عند المصادقة كمستخدم، يكون نطاق تفويض chat.memberships مطلوبًا.

  • عند المصادقة كتطبيق، يكون نطاق تفويض "chat.app.memberships" مطلوبًا. تتوفر المصادقة كتطبيق في

  • يمكنك ضبط user.type على HUMAN، وضبط user.name بالتنسيق users/{user}، حيث يمكن أن يكون {user} هو عنوان البريد الإلكتروني للمستخدم. بالنسبة إلى المستخدمين في مؤسسة Workspace نفسها، يمكن أن يكون {user} أيضًا id لشخص من People API، أو id للمستخدم في Directory API. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي للمستخدم في People API في user@example.com هو 123456789، يمكنك إضافة المستخدم إلى المساحة من خلال ضبط membership.member.name على users/user@example.com أو 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}

uid

string

النتائج فقط. مفتاح فريد لمورد الرموز التعبيرية المخصّصة.
emoji_name

string

غير قابل للتغيير. الاسم الذي يوفّره المستخدم للرمز التعبيري المخصّص، والذي يكون فريدًا في المؤسسة

مطلوب عند إنشاء الرمز التعبيري المخصّص، ويتم إخراجه فقط في الحالات الأخرى.

يجب أن تبدأ أسماء الرموز التعبيرية وتنتهي بنقطتَين، ويجب أن تكون بأحرف صغيرة ويمكن أن تحتوي فقط على أحرف أبجدية رقمية وواصلات وشرطات سفلية. يجب استخدام الواصلات والشرطات السفلية لفصل الكلمات ولا يمكن استخدامها بشكل متتابع.

مثلاً: :valid-emoji-name:

temporary_image_uri

string

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

payload

CustomEmojiPayload

الإدخال فقط بيانات الحمولة

CustomEmojiPayload

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

الحقول
file_content

bytes

مطلوب. الإدخال فقط. الصورة المستخدمة للرمز التعبيري المخصّص

يجب ألا يزيد حجم الحمولة عن 256 كيلوبايت، ويجب أن تتراوح أبعاد الصورة بين 64 و500 بكسل. إنّ القيود عرضة للتغيير.
filename

string

مطلوب. الإدخال فقط اسم ملف الصورة.

امتدادات الملفات المتوافقة: .png و.jpg و.gif.

DeleteCustomEmojiRequest

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

الحقول
name

string

مطلوب. اسم مورد الرمز التعبيري المخصّص المطلوب حذفه.

تنسيق الملف: customEmojis/{customEmoji}

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

DeleteMembershipRequest

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

الحقول
name

string

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

عند حذف اشتراك مستخدم، يجب استخدام النطاق chat.memberships وتنسيق spaces/{space}/members/{member}. يمكنك استخدام عنوان البريد الإلكتروني كعنوان بديل لـ {member}. على سبيل المثال، spaces/{space}/members/example@gmail.com حيث يكون example@gmail.com هو عنوان البريد الإلكتروني لمستخدم 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/example@gmail.com حيث يكون example@gmail.com هو عنوان البريد الإلكتروني لمستخدم Google Chat.

GetAttachmentRequest

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

الحقول
name

string

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

GetCustomEmojiRequest

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

الحقول
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/example@gmail.com حيث example@gmail.com هو عنوان البريد الإلكتروني لمستخدم 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/user@example.com/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/user@example.com/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

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

الحقول
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

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

الحقول
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) لهذا الرابط.
حقل الربط data بيانات المرجع المرتبط يمكن أن يكون data واحدًا فقط مما يلي:

RichLinkType

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

عمليات التعداد
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/example@gmail.com. لدعوة مستخدمي 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

النتائج فقط. الطابع الزمني لآخر رسالة في المساحة

admin_installed

bool

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

لتفعيل ميزة "التثبيت من خلال المشرف"، يجب أن يتضمّن تطبيق Chat ميزة المراسلة المباشرة.
membership_count

MembershipCount

النتائج فقط. يشير هذا المقياس إلى عدد العضويات في القناة مجمّعة حسب نوع العضوية. تتم تعبئة هذا الحقل عند ضبط space_type على SPACE أو DIRECT_MESSAGE أو GROUP_CHAT.

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 نفسها التي يستخدمها التطبيق.

لا تتم تعبئة هذا الحقل في الرسائل المباشرة.

حقل الربط 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.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

مطلوب. مسارات الحقول التي سيتم تعديلها افصل بين القيم المتعدّدة بفواصل أو استخدِم * لتعديل جميع مسارات الحقول.

مسارات الحقول المتوافقة حاليًا:
allow_missing

bool

اختياريّ. في حال عدم العثور على true والرسالة، يتم إنشاء رسالة جديدة ويتم تجاهل updateMask. يجب أن يكون معرّف الرسالة المحدّد client-assigned وإلا سيتعذّر تنفيذ الطلب.

UpdateSpaceReadStateRequest

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

الحقول
space_read_state

SpaceReadState

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

لا تتوافق هذه الميزة إلا مع تعديل حالة القراءة للمستخدم المتصل.

للإشارة إلى المستخدم الذي يتصل بتطبيقك، عليك ضبط أحد الخيارات التالية:

  • الاسم المستعار me مثلاً: users/me/spaces/{space}/spaceReadState

  • عنوان بريده الإلكتروني على Workspace. مثلاً: users/user@example.com/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} في طلبات البيانات من واجهة برمجة التطبيقات. على سبيل المثال، إذا كان رقم تعريف الملف الشخصي لمستخدم user@example.com في People API هو 123456789، يمكنك استخدام users/user@example.com كاسم بديل للإشارة إلى 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 هذا في حال تحديده.

TextButton

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

الحقول
text

string

النص المكتوب على الزر.
on_click

OnClick

إجراء onclick للزر

TextParagraph

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

الحقول
text

string