تشرح هذه الصفحة كيفية إنشاء صفحة رئيسية تطبيق Google Chat صفحة التطبيق الرئيسية هي واجهة بطاقة قابلة للتخصيص يرسله تطبيق في Chat إلى مستخدم عند فتح تطبيق باستخدام تطبيق Chat.
على سبيل المثال، يمكنك يمكنك إعداد رسالة بطاقة الصفحة الرئيسية للتطبيق لتشمل نصائح للتفاعل مع تطبيق Chat يستخدم أوامر الشرطة المائلة. بالنسبة إلى المستخدمين النهائيين، الصفحة الرئيسية للتطبيق هي متوفّرة فقط في رسالة مباشرة لتطبيق Chat إذا كانت يعمل مطور التطبيق بهذه الميزة.
يمكنك استخدام "أداة إنشاء البطاقات" لتصميم رسائل بطاقات JSON ومعاينتها لتطبيقات Chat:
فتح "أداة إنشاء البطاقات"المتطلبات الأساسية
Python
تطبيق Google Chat مفعَّل للميزات التفاعلية لإنشاء تطبيق Chat تفاعليًا باستخدام خدمة HTTP، أكمِل عملية البدء السريع هذه.
برمجة تطبيقات
تطبيق Google Chat مفعَّل للميزات التفاعلية لإنشاء تطبيق Chat التفاعلي في "برمجة تطبيقات Google"، أكمِل البدء السريع هذا.
Node.js
تطبيق Google Chat مفعَّل للميزات التفاعلية لإنشاء تطبيق Chat تفاعليًا باستخدام خدمة HTTP، أكمِل عملية البدء السريع هذه.
Java
تطبيق Google Chat مفعَّل للميزات التفاعلية لإنشاء تطبيق Chat تفاعليًا باستخدام خدمة HTTP، أكمِل عملية البدء السريع هذه.
ضبط Chat API
لإتاحة الصفحة الرئيسية للتطبيق، يجب تعديل إعدادات Chat API. في وحدة تحكُّم Google Cloud.
Python
في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > مزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API:
انقر على إدارة، ثم انقر على علامة التبويب الإعدادات.
ضَع علامة في مربّع الاختيار الصفحة الرئيسية لتطبيق الدعم.
في حقل عنوان URL للصفحة الرئيسية للتطبيق، أضِف عنوان URL. عادةً ما تكون هذه القيمة هي نفسها عنوان URL باعتباره عنوان URL للتطبيق. تم طلب عنوان URL هذا
APP_HOME
حدثًا.انقر على حفظ.
برمجة تطبيقات
في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > مزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API:
انقر على إدارة، ثم انقر على علامة التبويب الإعدادات.
ضَع علامة في مربّع الاختيار الصفحة الرئيسية لتطبيق الدعم.
انقر على حفظ.
Node.js
في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > مزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API:
انقر على إدارة، ثم انقر على علامة التبويب الإعدادات.
ضَع علامة في مربّع الاختيار الصفحة الرئيسية لتطبيق الدعم.
في حقل عنوان URL للصفحة الرئيسية للتطبيق، أضِف عنوان URL. عادةً ما تكون هذه القيمة هي نفسها عنوان URL باعتباره عنوان URL للتطبيق. تم طلب عنوان URL هذا
APP_HOME
حدثًا.انقر على حفظ.
Java
في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > مزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API:
انقر على إدارة، ثم انقر على علامة التبويب الإعدادات.
ضَع علامة في مربّع الاختيار الصفحة الرئيسية لتطبيق الدعم.
في حقل عنوان URL للصفحة الرئيسية للتطبيق، أضِف عنوان URL. عادةً ما تكون هذه القيمة هي نفسها عنوان URL باعتباره عنوان URL للتطبيق. تم طلب عنوان URL هذا
APP_HOME
حدثًا.انقر على حفظ.
إنشاء صفحة رئيسية للتطبيق
يتم بدء بطاقة الصفحة الرئيسية للتطبيق عندما يفتح المستخدِم رسالة مباشرة من تطبيق Chat ويمكن تحديثه كاستجابة من حدث تفاعلي مثل النقر على الزر أو إرسال النموذج أو إغلاق مربّع الحوار.
في المثال التالي، يعرض تطبيق Chat بطاقة رئيسية أولية للتطبيق تعرض وقت إنشاء البطاقة زر. وعندما ينقر أحد المستخدمين على الزرّ، سينتقل تطبيق Chat. بطاقة محدثة تعرض الوقت الذي تم فيه إنشاء البطاقة المحدثة.
إنشاء البطاقة الأولية للصفحة الرئيسية للتطبيق
لإنشاء صفحة رئيسية للتطبيق، يجب أن يتعامل تطبيق Chat مع
APP_HOME
حدث تفاعل وعرض مثيل
RenderActions
مع التنقل في pushCard
.
Python
برمجة تطبيقات
يمكنك تنفيذ الدالة onAppHome
التي يتم استدعاؤها بعد كل أحداث APP_HOME
:
يرسل هذا المثال رسالة بطاقة من خلال عرض بطاقة JSON. يمكنك أيضًا استخدام صفحة خدمة بطاقة "برمجة تطبيقات Google"
Node.js
Java
تعديل بطاقة رئيسية في التطبيق
إذا كانت بطاقة الصفحة الرئيسية للتطبيق الأولية تحتوي على تطبيقات مصغّرة تفاعلية، مثل الأزرار
البيانات المحدّدة، يجب أن يتعامل تطبيق Chat مع
أحداث التفاعل ذات الصلة عن طريق عرض مثيل
RenderActions
مع التنقل في updateCard
. لمعرفة المزيد حول التعامل مع التفاعلات
التطبيقات المصغّرة، راجع
معلومات العملية التي أدخلها المستخدمون:
Python
برمجة تطبيقات
يرسل هذا المثال رسالة بطاقة من خلال عرض بطاقة JSON. يمكنك أيضًا استخدام صفحة خدمة بطاقة "برمجة تطبيقات Google"
Node.js
Java
القيود
بشكل عام،
navigation
هو
غير متوفّر لتطبيقات Chat. لا يمكنك إرجاع حزمة من البطاقات.
فقط pushCard
(للاستجابة الأولية) وupdateCard
(للتحديثات) هي فقط
متوفّرة لتطبيقات Chat
مواضيع ذات صلة
- يمكنك الاطّلاع على نماذج تطبيقات Chat التي تستخدم الصفحة الرئيسية للتطبيق.
لفتح مربّع حوار، استخدِم تفاعل
OPEN_DIALOG
. لمزيد من المعلومات الرؤية فتح مربّع حوار استجابةً لبطاقة الصفحة الرئيسية للتطبيقلإغلاق مربّع حوار، استخدِم تفاعل
CLOSE_DIALOG
لإغلاق مربّع الحوار. والعودة إلى بطاقة الصفحة الرئيسية للتطبيق أو استخدامCLOSE_DIALOG_EXECUTE
تفاعل لإغلاق مربّع الحوار وإعادة تحميل بطاقة الصفحة الرئيسية للتطبيق. بالنسبة مزيد من المعلومات، راجع الردّ على مربّع حوار لبطاقة الصفحة الرئيسية للتطبيقللاطّلاع على مثال حول كيفية استخدام صفحة التطبيق الرئيسية، يُرجى الاطّلاع على إدارة المشاكل في تطبيق Chat ضمن الدرس التطبيقي حول الترميز إنشاء تطبيقات متوافقة مع Google Chat باستخدام Gemini: