تشرح هذه الصفحة كيفية إنشاء صفحة رئيسية للرسائل المباشرة باستخدام تطبيق Google Chat. الصفحة الرئيسية، التي يُشار إليها باسم الصفحة الرئيسية للتطبيق في Google Chat API ، هي واجهة بطاقة قابلة للتخصيص تظهر في علامة التبويب الصفحة الرئيسية لـ مساحات الرسائل المباشرة بين مستخدم وتطبيق Chat.
يمكنكم استخدام الصفحة الرئيسية للتطبيق لمشاركة نصائح حول التفاعل مع الـ Chat app أو السماح للمستخدمين بالوصول إلى واستخدام خدمة أو أداة خارجية من Chat.
استخدِموا أداة إنشاء البطاقات لتصميم واجهات المراسلة وواجهات المستخدم ومعاينتها لتطبيقات Chat:
فتح أداة إنشاء البطاقاتالمتطلبات الأساسية
Node.js
تطبيق Google Chat يتلقّى أحداث التفاعل ويردّ عليها لإنشاء تطبيق Chat تفاعلي باستخدام خدمة HTTP، يُرجى إكمال هذا التشغيل السريع.
Python
تطبيق Google Chat يتلقّى أحداث التفاعل ويردّ عليها لإنشاء تطبيق Chat تفاعلي باستخدام خدمة HTTP، يُرجى إكمال هذا التشغيل السريع.
جافا
تطبيق Google Chat يتلقّى أحداث التفاعل ويردّ عليها لإنشاء تطبيق Chat تفاعلي باستخدام خدمة HTTP، يُرجى إكمال هذا التشغيل السريع.
برمجة التطبيقات
تطبيق Google Chat يتلقّى أحداث التفاعل ويردّ عليها لإنشاء تطبيق Chat تفاعلي في "برمجة التطبيقات"، يُرجى إكمال هذا التشغيل السريع.
ضبط الصفحة الرئيسية لتطبيق Chat
لاستخدام الصفحة الرئيسية للتطبيق، يجب ضبط تطبيق Chat
لتلقّي
APP_HOME أحداث التفاعل،
يتلقّى تطبيق Chat هذا الحدث عندما ينقر المستخدم
على علامة التبويب الصفحة الرئيسية من رسالة مباشرة مع
تطبيق Chat.
لتعديل إعدادات الضبط في Google Cloud Console، يُرجى اتّباع الخطوات التالية:
- في Google Cloud Console، انقر على القائمة > واجهات برمجة التطبيقات والخدمات > واجهات برمجة التطبيقات والخدمات المفعَّلة > Google Chat API > الضبط. الانتقال إلى إعدادات Chat API
- ضمن الميزات التفاعلية ، انتقِل إلى قسم الوظائف ، واختَر استخدام الصفحة الرئيسية للتطبيق.
- إذا كان تطبيق Chat يستخدم خدمة HTTP، انتقِل إلى إعدادات الاتصال وحدِّد نقطة نهاية لحقل عنوان URL للصفحة الرئيسية للتطبيق. يمكنكم استخدام عنوان URL نفسه الذي حدّدتموه في حقل عنوان URL لنقطة نهاية HTTP.
- انقر على حفظ.
إنشاء بطاقة للصفحة الرئيسية للتطبيق
عندما يفتح المستخدم الصفحة الرئيسية للتطبيق، يجب أن يتعامل تطبيق Chat مع
حدث التفاعل APP_HOME من خلال عرض مثال على
RenderActions
مع عملية التنقّل pushCard و
Card. لإنشاء تجربة تفاعلية، يمكن أن تحتوي البطاقة على أدوات تفاعلية، مثل الأزرار أو مربّعات إدخال النصوص التي يمكن لتطبيق Chat معالجتها والردّ عليها باستخدام بطاقات إضافية أو مربّع حوار.
في المثال التالي، يعرض تطبيق Chat بطاقة أولية للصفحة الرئيسية للتطبيق تعرض وقت إنشاء البطاقة وزرًا. عندما ينقر المستخدم على الزر، يعرض تطبيق Chat بطاقة معدَّلة تعرض وقت إنشاء البطاقة المعدَّلة.
Node.js
Python
جافا
برمجة التطبيقات
تنفيذ الدالة onAppHome التي يتم استدعاؤها بعد جميع أحداث التفاعل APP_HOME:
يرسل هذا المثال رسالة بطاقة من خلال عرض JSON للبطاقة. يمكنكم أيضًا استخدام خدمة البطاقات في "برمجة التطبيقات".
الردّ على التفاعلات في الصفحة الرئيسية للتطبيق
إذا كانت البطاقة الأولية للصفحة الرئيسية للتطبيق تحتوي على أدوات تفاعلية، مثل الأزرار
أو مربّعات إدخال الاختيار، يجب أن يتعامل تطبيق Chat مع
أحداث التفاعل ذات الصلة من خلال عرض مثال على
RenderActions
مع updateCard عملية التنقّل. لمزيد من المعلومات حول التعامل مع الأدوات التفاعلية
، يُرجى الاطّلاع على مقالة
معالجة المعلومات التي يُدخلها المستخدمون.
في المثال السابق، كانت البطاقة الأولية للصفحة الرئيسية للتطبيق تتضمّن زرًا. عندما ينقر المستخدم على الزر، يؤدي حدث التفاعل CARD_CLICKED إلى تشغيل الدالة updateAppHome لتحديث بطاقة الصفحة الرئيسية للتطبيق، كما هو موضّح في الرمز التالي:
Node.js
Python
جافا
برمجة التطبيقات
يرسل هذا المثال رسالة بطاقة من خلال عرض JSON للبطاقة. يمكنكم أيضًا استخدام خدمة البطاقات في "برمجة التطبيقات".
فتح مربّعات الحوار
يمكن لتطبيق Chat أيضًا الردّ على التفاعلات في الصفحة الرئيسية للتطبيق من خلال فتح مربّعات الحوار.
لفتح مربّع حوار من الصفحة الرئيسية للتطبيق، يجب معالجة حدث التفاعل ذي الصلة من خلال
عرض renderActions مع عملية التنقّل updateCard التي تحتوي على عنصر Card. في المثال التالي، يردّ تطبيق Chat على نقرة زر من بطاقة الصفحة الرئيسية للتطبيق من خلال معالجة حدث التفاعل CARD_CLICKED وفتح مربّع حوار:
{ renderActions: { action: { navigations: [{ updateCard: { sections: [{
header: "Add new contact",
widgets: [{ "textInput": {
label: "Name",
type: "SINGLE_LINE",
name: "contactName"
}}, { textInput: {
label: "Address",
type: "MULTIPLE_LINE",
name: "address"
}}, { decoratedText: {
text: "Add to favorites",
switchControl: {
controlType: "SWITCH",
name: "saveFavorite"
}
}}, { decoratedText: {
text: "Merge with existing contacts",
switchControl: {
controlType: "SWITCH",
name: "mergeContact",
selected: true
}
}}, { buttonList: { buttons: [{
text: "Next",
onClick: { action: { function: "openSequentialDialog" }}
}]}}]
}]}}]}}}
لإغلاق مربّع حوار، يجب معالجة أحداث التفاعل التالية:
CLOSE_DIALOG: يؤدي هذا الحدث إلى إغلاق مربّع الحوار والعودة إلى البطاقة الأولية للصفحة الرئيسية لتطبيق Chat.CLOSE_DIALOG_AND_EXECUTE: يؤدي هذا الحدث إلى إغلاق مربّع الحوار وتحديث بطاقة الصفحة الرئيسية للتطبيق.
يستخدم نموذج الرمز التالي CLOSE_DIALOG لإغلاق مربّع حوار والعودة إلى بطاقة الصفحة الرئيسية للتطبيق:
{ renderActions: { action: {
navigations: [{ endNavigation: { action: "CLOSE_DIALOG" }}]
}}}
لجمع المعلومات من المستخدمين، يمكنكم أيضًا إنشاء مربّعات حوار متسلسلة. للتعرّف على كيفية إنشاء مربّعات حوار متسلسلة، يُرجى الاطّلاع على مقالة فتح مربّعات الحوار والردّ عليها.
مواضيع ذات صلة
- عرض نماذج تطبيقات Chat التي تستخدم الصفحة الرئيسية للتطبيق
- فتح مربّعات الحوار والردّ عليها.