REST Resource: spaces.threads

المورد: Thread

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

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

تمثيل JSON 
{
  "name": string,
  "threadKey": string,
  "threadMetadata": {
    object (ThreadMetadata)
  }
}
الحقول
name

string

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

مثلاً: spaces/{space}/threads/{thread}
threadKey

string

اختيارية: إدخال لإنشاء سلسلة محادثات أو تعديلها وإلا، ستكون النتائج فقط. رقم تعريف سلسلة المحادثات يمكن إدخال ما يصل إلى 4,000 حرف.

يكون هذا المعرّف فريدًا لتطبيق Chat الذي يضبطه. على سبيل المثال، إذا أنشأت عدة تطبيقات في Chat رسالة باستخدام مفتاح سلسلة المحادثات نفسه، يتم نشر الرسائل في سلاسل محادثات مختلفة. للردّ في سلسلة محادثات أنشأها مستخدم أو تطبيق Chat آخر، حدِّد حقل سلسلة المحادثات name بدلاً من ذلك.
threadMetadata

object (ThreadMetadata)

اختيارية: البيانات الوصفية لسلسلة المحادثات لعرض هذه السلسلة وإدارتها كجلسة

ThreadMetadata

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

تمثيل JSON 
{
  "title": string,
  "icon": {
    object (Icon)
  }
}
الحقول
title

string

اختيارية: عنوان سلسلة المحادثات عنوان يصف موضوع الجلسة

الحد الأقصى للطول هو 1024 حرفًا.

في حال عدم تحديدها، يتم ضبطها تلقائيًا على الرسالة الأولى في الجلسة.
icon

object (Icon)

اختيارية: رمز سلسلة المحادثات رمز يظهر بجانب عنوان الجلسة

يُسمح فقط باستخدام الرموز المتوافقة مع إرشادات التصميم المتعدّد الأبعاد. في حال عدم تحديدها، يتم ضبطها تلقائيًا على رمز Material Icon الخاص بـ الملاحظات.

رمز

رمز معروض في طلب أو سلسلة محادثات

تمثيل JSON 
{
  "altText": string,

  "materialIcon": {
    object (MaterialIcon)
  }
}
الحقول
altText

string

اختيارية: النص البديل لهذا الرمز الذي يُستخدم لتسهيل الاستخدام
رمز معروض في طلب في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
materialIcon

object (MaterialIcon)

يعرض أحد رموز Google Material.

على سبيل المثال، لعرض رمز مربّع اختيار، استخدِم

"materialIcon": {
  "name": "check_box"
}
نهاية الحقول التي يستبعد كلّ منها الآخر

الطُرق

get

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

list

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

patch

 تعديل سلسلة محادثات في مساحة رسالة مباشرة بين مستخدم وتطبيق