حدث تفاعل مع تطبيق Google Chat يمثّل بيانات عن تفاعل المستخدم مع تطبيق Chat ويتضمّن بيانات حول ذلك لضبط تطبيقك في Chat لتلقّي أحداث التفاعل، يُرجى الاطّلاع على مقالة تلقّي تفاعلات المستخدمين والردّ عليها.
بالإضافة إلى تلقّي أحداث من تفاعلات المستخدمين، يمكن لتطبيقات Chat تلقّي أحداث حول التغييرات التي تطرأ على المساحات، مثل إضافة عضو جديد إلى مساحة. للتعرّف على أحداث المساحة، يُرجى الاطّلاع على مقالة التعامل مع الأحداث من Google Chat.
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع تفاعل المستخدم مع تطبيق Chat، مثلاً |
eventTime |
الطابع الزمني الذي يشير إلى وقت وقوع الحدث التفاعلي. |
token |
قيمة سرية يمكن لتطبيقات Chat القديمة استخدامها للتحقّق مما إذا كان الطلب من Google. تنشئ Google الرمز المميز بشكل عشوائي، وتظل قيمته ثابتة. يمكنك الحصول على الرمز المميّز أو إبطاله أو إعادة إنشائه من صفحة ضبط واجهة Chat API في Google Cloud Console. لا تستخدِم تطبيقات Chat الحديثة هذا الحقل. ولا تتوفّر هذه الميزة في الردود من واجهة برمجة التطبيقات وصفحة ضبط واجهة Chat API. |
threadKey |
المفتاح المحدّد من خلال تطبيق Chat لسلسلة المحادثات المرتبطة بحدث التفاعل يمكنك الانتقال إلى |
message |
الرسالة التي أدّت إلى بدء حدث التفاعل، إذا كان ذلك منطبقًا. |
user |
المستخدِم الذي تفاعل مع تطبيق Chat |
space |
المساحة التي تفاعل فيها المستخدم مع تطبيق Chat. |
action |
بالنسبة إلى أحداث تفاعل |
configCompleteRedirectUrl |
بالنسبة إلى أحداث تفاعل " |
isDialogEvent |
بالنسبة إلى أحداث التفاعل بين |
dialogEventType |
نوع حدث التفاعل المربّع الذي تم تلقّيه. |
common |
يمثل ذلك معلومات عن عميل المستخدم، مثل اللغة والتطبيق المضيف والنظام الأساسي. بالنسبة إلى تطبيقات Chat، يتضمن |
CommonEventObject
يمثل ذلك معلومات عن عميل المستخدم، مثل اللغة والتطبيق المضيف والنظام الأساسي. بالنسبة إلى تطبيقات Chat، يتضمن CommonEventObject
البيانات التي يرسلها المستخدمون الذين يتفاعلون مع البطاقات، مثل البيانات التي يتم إدخالها في مربعات الحوار.
تمثيل JSON |
---|
{ "userLocale": string, "hostApp": enum ( |
الحقول | |
---|---|
userLocale |
تمثّل هذه السمة |
hostApp |
تعداد HostApp الذي يشير إلى التطبيق الذي تم استدعاء الإضافة منه |
platform |
تعداد المنصة الذي يشير إلى المنصّة التي نشأ منها الحدث ( |
timeZone |
رقم تعريف المنطقة الزمنية والمعادلة من التوقيت العالمي المنسَّق (UTC). لا تتوفّر هذه الميزة إلا لنوعَي الحدث |
formInputs |
خريطة تحتوي على القيم التي يُدخلها المستخدم في أداة من بطاقة أو مربّع حوار مفاتيح الخريطة هي أرقام تعريف السلاسل المخصصة لكل تطبيق مصغّر، وتمثل القيم مدخلات إلى التطبيق المصغّر. لمعرفة التفاصيل، يمكنك الاطّلاع على معلومات العملية التي أدخلها المستخدمون. |
parameters |
تم تمرير المَعلمات المخصَّصة إلى الدالة التي تم استدعاؤها. يجب أن تكون كل من المفاتيح والقيم سلاسل. |
invokedFunction |
اسم الدالة التي تم استدعاؤها والمرتبطة بالأداة. يتم ضبط هذا الإعداد لتطبيقات Chat فقط. |
TimeZone
رقم تعريف المنطقة الزمنية والمعادلة من التوقيت العالمي المنسَّق (UTC). لا تتوفّر هذه الميزة إلا لنوعَي الحدث CARD_CLICKED
وSUBMIT_DIALOG
.
تمثيل JSON |
---|
{ "id": string, "offset": integer } |
الحقول | |
---|---|
id |
رمز قاعدة بيانات المنطقة الزمنية IANA TZ، مثل "America/Toronto" |
offset |
معادلة المنطقة الزمنية للمستخدم بالمللي ثانية من التوقيت العالمي المنسَّق (UTC) |
مدخلات
أنواع البيانات التي يمكن للمستخدمين إدخالها في البطاقات أو مربّعات الحوار يعتمد نوع الإدخال على نوع القيم التي تقبلها الأداة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون |
|
stringInputs |
قائمة بالسلاسل التي تمثّل القيم التي يُدخلها المستخدم في الأداة. إذا كانت الأداة تقبل قيمة واحدة فقط، مثل أداة |
dateTimeInput |
قيم إدخال التاريخ والوقت من تطبيق |
dateInput |
قيم التاريخ الذي يتم إدخاله من تطبيق |
timeInput |
قيم إدخال الوقت من تطبيق |
StringInputs
معلمة الإدخال للتطبيقات المصغّرة العادية. أما بالنسبة إلى التطبيقات المصغّرة ذات القيمة الواحدة، فهي عبارة عن قائمة قيمة واحدة. بالنسبة إلى التطبيقات المصغّرة متعددة القيم، مثل مربّع الاختيار، يتم عرض جميع القيم.
تمثيل JSON |
---|
{ "value": [ string ] } |
الحقول | |
---|---|
value[] |
قائمة بالسلاسل التي أدخلها المستخدم. |
DateTimeInput
قيم إدخال التاريخ والوقت
تمثيل JSON |
---|
{ "msSinceEpoch": string, "hasDate": boolean, "hasTime": boolean } |
الحقول | |
---|---|
msSinceEpoch |
الوقت منذ وقت الحقبة بالمللي ثانية |
hasDate |
ما إذا كان الإدخال |
hasTime |
ما إذا كان الإدخال |
DateInput
قيم إدخال التاريخ
تمثيل JSON |
---|
{ "msSinceEpoch": string } |
الحقول | |
---|---|
msSinceEpoch |
الوقت منذ وقت الحقبة بالمللي ثانية |
TimeInput
قيم إدخال الوقت
تمثيل JSON |
---|
{ "hours": integer, "minutes": integer } |
الحقول | |
---|---|
hours |
الساعة بنظام 24 ساعة. |
minutes |
عدد الدقائق بعد الساعة. القيم الصالحة هي من 0 إلى 59. |