يوضّح هذا الدليل كيف يمكن لتطبيقات Google Chat جمع المعلومات من المستخدمين ومعالجتها من خلال إنشاء إدخالات نماذج في واجهات مستندة إلى البطاقات.
تطلب تطبيقات Chat معلومات من المستخدمين لتنفيذ إجراءات في Chat أو خارجه، بما في ذلك الطرق التالية:
- ضبط الإعدادات على سبيل المثال، للسماح للمستخدمين بتخصيص إعدادات الإشعارات أو ضبط تطبيق Chat وإضافته إلى مساحة واحدة أو أكثر .
- إنشاء معلومات أو تعديلها في تطبيقات Google Workspace الأخرى على سبيل المثال، اسمح للمستخدمين بإنشاء حدث في تقويم Google.
- يتم السماح للمستخدمين بالوصول إلى الموارد وتعديلها في التطبيقات أو خدمات الويب الأخرى. على سبيل المثال، يمكن أن يساعد تطبيق Chat المستخدمين في تعديل حالة طلب الدعم مباشرةً من "مساحة Chat".
المتطلبات الأساسية
Node.js
تطبيق Google Chat مفعَّل فيه الميزات التفاعلية لإنشاء تطبيق Chat تفاعلي باستخدام خدمة HTTP، أكمِل عملية البدء السريع هذه.
Python
تطبيق Google Chat مفعَّل فيه الميزات التفاعلية لإنشاء تطبيق Chat تفاعلي باستخدام خدمة HTTP، أكمِل عملية البدء السريع هذه.
Java
تطبيق Google Chat مفعَّل فيه الميزات التفاعلية لإنشاء تطبيق Chat تفاعلي باستخدام خدمة HTTP، أكمِل الخطوات الأساسية هذه.
برمجة تطبيقات
تطبيق Google Chat مفعَّل للميزات التفاعلية لإنشاء تطبيق Chat تفاعلي في "برمجة تطبيقات Google"، أكمِل البدء السريع هذا.
إنشاء نماذج باستخدام البطاقات
لجمع المعلومات، تعمل تطبيقات Chat على تصميم النماذج وإدخالاتها، ودمجها في بطاقات. لعرض البطاقات للمستخدمين، يمكن لتطبيقات Chat استخدام واجهات Chat التالية:
- الرسائل التي تتضمّن بطاقة واحدة أو أكثر.
- الصفحات الرئيسية: وهي بطاقة تظهر من علامة التبويب الصفحة الرئيسية في الرسائل المباشرة باستخدام تطبيق Chat.
- المحادثات، وهي بطاقات يتم فتحها في نافذة جديدة من الرسائل والصفحات الرئيسية
يمكن لتطبيقات Chat إنشاء البطاقات باستخدام التطبيقات المصغّرة التالية:
التطبيقات المصغّرة لإدخال البيانات في النماذج التي تطلب معلومات من المستخدِمين يمكنك اختياريًا إضافة عمليات التحقّق إلى التطبيقات المصغّرة لإنشاء نماذج إدخال، لضمان إدخال المستخدمين للمعلومات وتنسيقها بشكلٍ صحيح. يمكن لتطبيقات Chat استخدام أدوات الإدخال التالية:
- مدخلات نصية
(
textInput
) للنص الذي لا يتّبع تنسيقًا معيّنًا أو النص المقترَح - إدخالات الاختيار
(
selectionInput
) هي عناصر يمكن اختيارها في واجهة المستخدم، مثل مربّعات الاختيار وأزرار الاختيار والقوائم المنسدلة. يمكن لأدوات إدخال التحديد أيضًا ملء العناصر من مصادر بيانات ثابتة أو ديناميكية. على سبيل المثال، يمكن للمستخدمين الاختيار من قائمة مساحات Chat التي ينتمون إليها. - أداة اختيار التاريخ والوقت
(
dateTimePicker
) لإدخالات التاريخ والوقت
- مدخلات نصية
(
تطبيق مصغّر زر لكي يتمكّن المستخدمون من إرسال القيم التي أدخلوها في البطاقة بعد أن ينقر مستخدم على الزرّ، يمكن لتطبيق Chat معالجة المعلومات التي يتلقّاها.
في المثال التالي، تجمع البطاقة معلومات الاتصال باستخدام أداة إدخال النص ومنتقي التاريخ والوقت والاختيار المصغّر للإدخال:
Node.js
Python
Java
برمجة تطبيقات
للحصول على المزيد من الأمثلة على التطبيقات المصغّرة التفاعلية التي يمكنك استخدامها لجمع المعلومات، راجِع تصميم بطاقة تفاعلية أو مربّع حوار.
تلقّي البيانات من التطبيقات المصغّرة التفاعلية
عندما ينقر المستخدمون على زر، تتلقّى تطبيقات Chat
CARD_CLICKED
حدث تفاعل
يحتوي على معلومات عن التفاعل. تحتوي الحمولة لأحداث
CARD_CLICKED
التفاعل على عنصر common.formInputs
مع أي قيم يُدخلها المستخدم.
يمكنك استرداد القيم من الكائن common.formInputs.WIDGET_NAME
، حيث يشير WIDGET_NAME إلى حقل name
الذي حدّدته للأداة.
يتم عرض القيم كنوع بيانات محدّد للتطبيق المصغّر (يتم تمثيله ككائن
Inputs
).
يعرض ما يلي جزءًا من حدث تفاعُل CARD_CLICKED
حيث CARD_CLICKED
أدخَل المستخدِم قيمًا لكلّ تطبيق مصغّر:
HTTP
{
"type": "CARD_CLICKED",
"common": { "formInputs": {
"contactName": { "stringInputs": {
"value": ["Kai 0"]
}},
"contactBirthdate": { "dateInput": {
"msSinceEpoch": 1000425600000
}},
"contactType": { "stringInputs": {
"value": ["Personal"]
}}
}}
}
برمجة تطبيقات
{
"type": "CARD_CLICKED",
"common": { "formInputs": {
"contactName": { "": { "stringInputs": {
"value": ["Kai 0"]
}}},
"contactBirthdate": { "": { "dateInput": {
"msSinceEpoch": 1000425600000
}}},
"contactType": { "": { "stringInputs": {
"value": ["Personal"]
}}}
}}
}
لتلقّي البيانات، يتعامل تطبيق Chat مع حدث التفاعل للحصول على القيم التي يُدخلها المستخدمون في الأدوات. يوضّح الجدول التالي كيفية الحصول على قيمة لأداة عرض إدخال نموذج معيّنة. وبالنسبة إلى كل تطبيق مصغّر، يعرض الجدول نوع البيانات التي تقبله، بالإضافة إلى مثال على القيمة التي يتم تخزينها في حدث التفاعل.
أداة إدخال النموذج | نوع بيانات الإدخال | القيمة التي تم إدخالها من حدث التفاعل | مثال على القيمة |
---|---|---|---|
textInput |
stringInputs |
event.common.formInputs.contactName.stringInputs.value[0] |
Kai O |
selectionInput |
stringInputs |
للحصول على القيمة الأولى أو الوحيدة، event.common.formInputs.contactType.stringInputs.value[0] |
Personal |
dateTimePicker التي تقبل التواريخ فقط |
dateInput |
event.common.formInputs.contactBirthdate.dateInput.msSinceEpoch . |
1000425600000 |
نقل البيانات إلى بطاقة أخرى
بعد أن يرسل المستخدم معلومات من بطاقة، قد تحتاج إلى عرض بطاقات إضافية لإجراء أي مما يلي:
- ساعِد المستخدمين على إكمال نماذج أطول من خلال إنشاء أقسام مختلفة.
- اسمح للمستخدمين بمعاينة المعلومات وتأكيدها من البطاقة الأولية، حتى يتمكنوا من مراجعة إجاباتهم قبل الإرسال.
- ملء الأجزاء المتبقية من النموذج ديناميكيًا على سبيل المثال، لطلب إنشاء موعد من المستخدمين، يمكن لتطبيق Chat عرض بطاقة أولية تطلب سبب الموعد، ثم تعبئة بطاقة أخرى توفّر الأوقات المتاحة استنادًا إلى نوع الموعد.
لنقل بيانات الإدخال من البطاقة الأولية، يمكنك إنشاء button
أداة مصغّرة باستخدام actionParameters
التي تحتوي على name
الأداة المصغّرة والقيمة التي يُدخلها المستخدم، كما هو موضّح
في المثال التالي:
Node.js
Python
Java
برمجة تطبيقات
عندما ينقر أحد المستخدمين على الزر، يتلقّى تطبيقك في Chat حدث تفاعل CARD_CLICKED
يمكنك من خلاله تلقّي البيانات.
الردّ على نموذج تم إرساله
بعد استلام البيانات من رسالة بطاقة أو مربّع حوار، يستجيب تطبيق Chat إما من خلال الإقرار بالاستلام أو بإرجاع الخطأ.
في المثال التالي، يُرسِل تطبيق Chat رسالة نصية لتأكيد استلام نموذج تم إرساله من حوار أو رسالة بطاقة بنجاح.
Node.js
Python
Java
برمجة تطبيقات
لمعالجة مربّع حوار وإغلاقه، عليك عرض كائن
ActionResponse
يحدّد ما إذا كنت تريد إرسال رسالة تأكيد أو تعديل
الرسالة أو البطاقة الأصلية أو إغلاق مربّع الحوار فقط. لمعرفة الخطوات، يُرجى الاطّلاع على مقالة
إغلاق مربّع حوار.
تحديد المشاكل وحلّها
عندما يعرض تطبيق أو بطاقة Google Chat رسالة خطأ، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذّرت معالجة طلبك". في بعض الأحيان، لا تعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن يعرض تطبيق Chat أو بطاقة بياناته نتيجة غير متوقعة، على سبيل المثال، قد لا تظهر رسالة بطاقة.
على الرغم من أنّ رسالة الخطأ قد لا تظهر في واجهة مستخدم Chat، تتوفّر رسائل الخطأ الوصفية وبيانات السجلّ لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة بشأن الاطّلاع على الأخطاء وتصحيحها وتصحيحها، راجِع تحديد المشاكل في Google Chat وحلّها.
مواضيع ذات صلة
- الاطّلاع على نموذج "إدارة جهات الاتصال"، وهو تطبيق في Chat يطلب من المستخدمين إكمال نموذج تواصل من رسائل البطاقات ومربّعات الحوار.
- فتح مربّعات حوار تفاعلية