تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح هذه الصفحة كيفية إعداد إصدار تجريبي من تطبيقك على Google Chat وتثبيته لتتمكّن من تجربة الميزات التفاعلية، مثل أوامر تطبيقات Chat والمراسلة
المباشرة ومعاينات
الروابط، قبل طرحها للمستخدمين النهائيين.
من خلال اختبار تطبيق Chat، يمكنك التأكّد من أنّه يقدّم تجربة مستخدم عالية الجودة ويعمل على النحو المتوقّع. إذا كنت ستنشر تطبيق Chat بشكل علني، سيساعدك الاختبار أيضًا في التأكّد من أنّ تطبيق Chat يستوفي متطلبات الإدراج في
Google Workspace Marketplace.
لاختبار تطبيق Chat بأمان في كل مرحلة من مراحل دورة حياته، ننصحك بإعداد بيئات منفصلة للتطوير والتجهيز والإصدار العلني. في كل بيئة، عليك إنشاء تطبيق Chat مختلف ونشره. للتعرّف على كيفية إعداد البيئات، راجِع مقالة إنشاء عمليات نشر وإدارتها لتطبيق Google Chat.
المتطلبات الأساسية
تطبيق Google Chat تم إعداده لتلقّي أحداث التفاعل والردّ عليها لإنشاء تطبيق تفاعلي على Chat، أكمل أحد أدلة البدء السريع التالية استنادًا إلى بنية التطبيق التي تريد استخدامها:
يجب أن ينتمي أي مستخدم يختبر تطبيق Chat إلى مؤسسة Google Workspace نفسها التي تم فيها ضبط تطبيق Chat.
تأكَّد من أنّ لديك إذنًا باختبار تطبيق Chat وتثبيته في مؤسسة Google Workspace. للحصول على التفاصيل، يُرجى الاطّلاع على
ضبط إذن الوصول لمؤسسات Google Workspace
في مستندات Google Workspace Marketplace.
إضافة مختبِرين موثوق بهم
بالنسبة إلى تطبيقات Chat التفاعلية، تتيح لك واجهة برمجة التطبيقات في Chat مشاركة تطبيق Chat مع مستخدمين محدّدين في مؤسسة Google Workspace. يمكن للمستخدمين الذين تحدّدهم إضافة تطبيق Chat إلى مساحة واختبار ميزاته قبل نشره في Marketplace. لاختبار تطبيق Chat، عليك إضافة نفسك كمختبِر موثوق به.
لإتاحة تطبيق الاختبار على Chat لك وللمستخدمين الآخرين في مؤسستك، عدِّل إعداد إمكانية الوصول في Chat API
في Google Cloud Console:
في Google Cloud Console، افتح صفحة Google Chat API:
انتقِل إلى الميزات التفاعلية > الظهور، ثم اختَر إتاحة تطبيق Chat هذا لمستخدمين ومجموعات محدّدة في GOOGLE_WORKSPACE_ORGANIZATION، حيث GOOGLE_WORKSPACE_ORGANIZATION هو اسم مؤسستك.
في الحقل الذي يظهر بعد وضع علامة في مربّع الاختيار، أدخِل عناوين البريد الإلكتروني للمستخدمين أو مجموعات Google التي تريد منحها إذن الوصول إلى تطبيق Chat، مع الفصل بينها بفواصل. لاختبار تطبيق Chat الخاص بك، أدخِل عنوان البريد الإلكتروني الذي تستخدمه للوصول إلى Google Chat.
انقر على حفظ.
إضافة تطبيق Chat إلى المساحات
لبدء اختبار الميزات التفاعلية، عليك إضافة تطبيق Chat إلى مساحة واحدة أو أكثر، مثل رسالة مباشرة أو رسالة جماعية أو مساحة تحمل اسمًا. إذا لم تتم إضافة جميع الأعضاء في المساحة كمختبِرين موثوق بهم، قد يتمكّنون من رؤية تطبيق Chat في المساحة ولكن لن يتمكّنوا من التفاعل معه مباشرةً.
لا تظهر تطبيقات المحادثة التي لم يتم نشرها في نتائج بطاقة البيانات من Google Workspace Marketplace. للعثور على تطبيقات Chat غير منشورة في Google Chat، يمكنك البحث عن تطبيق Chat، أو العثور عليه ضمن
add_circle_outline أدوات Google Workspace أثناء كتابة رسالة، أو الإشارة إلى تطبيق Chat باستخدام @في رسالة.
لإضافة تطبيق Chat إلى مساحة، اتّبِع الخطوات التالية:
افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عند إضافة نفسك كمختبِر موثوق به.
لبدء رسالة مباشرة باستخدام تطبيق Chat، اتّبِع الخطوات التالية:
انقر على addمحادثة جديدة.
في حقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.
اختَر تطبيق Chat من النتائج. سيتم فتح رسالة مباشرة.
لإضافة تطبيق Chat إلى مساحة حالية، اتّبِع الخطوات التالية:
ضمن المساحات، انقر على اسم المساحة.
في حقل الرسالة الجديدة في مساحة Chat، أدخِل @ واسم تطبيق Chat، ثم اختَر تطبيق Chat من النتائج.
اضغط على Enter أو انقر على
send إرسال.
إذا ظهرت نافذة اسم المساحة الإضافة إلى، انقر على الإضافة إلى المساحة. يتم نشر رسالتك التي تتضمّن الإشارة @في مساحة Chat.
يظهر أيضًا نص يوضّح أنّك أضفت تطبيق Chat إلى المساحة.
يمكنك الآن اختبار تطبيق Chat في المساحة.
عند اختبار تطبيق Chat، عليك مراجعة جميع الميزات ثم تسجيل أي أخطاء تواجهها وإصلاحها. لفهم رسائل الخطأ ومعالجتها، يُرجى الاطّلاع على تحديد مشاكل Google Chat وحلّها.
مراجعة تطبيق Chat واختباره في Google Workspace Marketplace
لتوزيع تطبيق Chat ومشاركته مع أي مستخدم غير مدرَج ضمن قائمة المختبِرين الموثوق بهم، عليك ضبط تطبيق Chat ونشره في Google Workspace Marketplace. لمعرفة التفاصيل، يُرجى الاطّلاع على نشر التطبيقات على Google Workspace Marketplace.
إذا أردت نشر تطبيق Chat بشكل علني على Google Workspace Marketplace، عليك إرسال تطبيق Chat للمراجعة. تراجع Google تطبيق Chat للتأكّد من أنّه يستوفي جميع متطلبات Marketplace. للتعرّف على العملية والمتطلبات، يُرجى الاطّلاع على عملية مراجعة التطبيقات ومتطلباتها للحصول على Google Workspace Marketplace.
تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide explains how to set up a test version of your Google Chat app to try out interactive features before releasing it to users.\u003c/p\u003e\n"],["\u003cp\u003eYou can add trusted testers within your organization to access and provide feedback on your Chat app before public release.\u003c/p\u003e\n"],["\u003cp\u003eTo test your app, you need to add it to a space in Google Chat, like a direct message or a group chat, where you can interact with its features.\u003c/p\u003e\n"],["\u003cp\u003eBefore publishing your Chat app to the Google Workspace Marketplace, ensure it's thoroughly tested and reviewed to meet all requirements for a smooth user experience.\u003c/p\u003e\n"],["\u003cp\u003eIf you intend to publish your app publicly, it will be subject to a review process by Google to ensure it aligns with Marketplace guidelines.\u003c/p\u003e\n"]]],["To test a Google Chat app with interactive features, configure the app's visibility in the Google Cloud console to make it available to specific testers within your organization. Add testers' email addresses or Google Groups. Then, add the app to Google Chat spaces, either via direct message or by @mentioning it in an existing space. Testers should use the organization's Google Workspace account. Finally, thoroughly test the app's features, troubleshoot errors, and, if applicable, prepare it for publishing on the Google Workspace Marketplace.\n"],null,["| **Note:** This guide explains how to build an interactive Chat app\n| using *Chat API interaction events* . You can also build your\n| Chat app as a Google Workspace add-on. To learn about which framework\n| to use, see [Build an interactive\n| Google Chat app](/workspace/chat/interact-users-overview).\n\n\u003cbr /\u003e\n\nThis page explains how to configure and install a test version of your\nGoogle Chat app so that you can try out interactive features---such as\n[Chat app commands](/workspace/chat/commands), [direct\nmessaging](/workspace/chat/create-messages), and [link\npreviews](/workspace/chat/preview-links)---before releasing them to end users.\n\nBy testing your Chat app, you can ensure that it offers\na high-quality user experience and functions as expected. If you're publishing\nyour Chat app publicly, testing also helps you make\nsure that your Chat app meets the [requirements for\nbeing listed in the\nGoogle Workspace Marketplace](/workspace/marketplace/about-app-review).\n\nTo safely test at each phase of your Chat app's\nlifecycle, we recommend that you set up separate environments for development,\nstaging, and production. In each environment, you should create and deploy a\ndifferent Chat app. To learn how to set up\nenvironments, see [Create and manage deployments for your\nGoogle Chat app](/workspace/chat/create-manage-deployments).\n\nPrerequisites\n\n\u003cbr /\u003e\n\n- A Google Chat app that's configured to receive and respond to [interaction events](/workspace/chat/receive-respond-interactions). To create an interactive Chat app, complete one of the following quickstarts based on the [app architecture](/workspace/chat/structure) that you want to use:\n - [HTTP service](/workspace/chat/quickstart/gcf-app) with Google Cloud Functions\n - [Google Apps Script](/workspace/chat/quickstart/apps-script-app)\n - [Google Cloud Dialogflow CX](/workspace/chat/build-dialogflow-chat-app-natural-language)\n - [Google Cloud Pub/Sub](/workspace/chat/quickstart/pub-sub)\n- To grant access to your Chat app for testing:\n\n - You must have the [`chat.owner`](https://cloud.google.com/iam/docs/understanding-roles.md#hangouts-chat-roles) IAM role . You can also have this role as an [editor or\n owner](https://cloud.google.com/resource-manager/docs/access-control-proj#basic_roles) of the Google Cloud project associated with the Chat app. For details, see [Grant an IAM role by\n using the\n Google Cloud console](https://cloud.google.com/iam/docs/grant-role-console) in the Google Cloud documentation.\n - Anyone who tests the Chat app must belong to the same Google Workspace organization where your Chat app is configured.\n- Ensure that you have access to test and install the\n Chat app in your Google Workspace\n organization. For details, see\n [Configure access for Google Workspace organizations](/workspace/marketplace/how-to-publish#configure-access)\n in the Google Workspace Marketplace documentation.\n\nAdd trusted testers\n\nFor interactive Chat apps, the Chat API lets you share\nyour Chat app with specific people in your\nGoogle Workspace organization. The people that you specify can add the\nChat app to a space and test its features before you\npublish it to the Marketplace. To test your own\nChat app, you must add yourself as a trusted tester.\n\nTo make your test Chat app available to you and others\nin your organization, update the Chat API **Visibility** setting\nin Google Cloud console:\n\n1. In the Google Cloud console, open the Google Chat API page: [Go to Google Chat API page](https://console.cloud.google.com/apis/api/chat.googleapis.com)\n\n2. Click the **Configuration** tab.\n3. Go to **Interactive features** \\\u003e **Visibility** , and then select the **Make this Chat app available to specific people and groups in\n \u003cvar translate=\"no\"\u003eGOOGLE_WORKSPACE_ORGANIZATION\u003c/var\u003e** , where \u003cvar translate=\"no\"\u003eGOOGLE_WORKSPACE_ORGANIZATION\u003c/var\u003e is the name of your organization.\n4. In the field that appears after selecting the checkbox, enter the email addresses of the people or Google Groups that you want to access your Chat app, separated by commas. To test your own Chat app, enter the email address that you use to access Google Chat.\n5. Click **Save**.\n\nAdd your Chat app to spaces\n\nTo start testing interactive features, you must add your\nChat app to one or more spaces, such as a direct\nmessage, group message, or named space. If you haven't added all the members in\nthe space as trusted testers, they might be able to see the\nChat app in the space but can't interact directly with\nit.\n\nChat apps that haven't been published don't appear\nin the listing results from the Google Workspace Marketplace. To find\nunpublished Chat apps in Google Chat, you can search for the Chat app, find it under add_circle_outline **Google Workspace tools** while composing a\nmessage, or @mention the Chat app in a message.\n\nTo add your Chat app to a space, do the following:\n\n1. Open Google Chat using the Google Workspace account that you\n provided when you added yourself as a trusted tester.\n\n [Go to Google Chat](https://chat.google.com)\n2. To start a direct message with the Chat app, do the following:\n 1. Click add **New chat**.\n 2. In the **Add 1 or more people** field, type the name of your Chat app.\n 3. Select your Chat app from the results. A direct message opens.\n3. To add the Chat app to an existing space, do to the following:\n 1. Under **Spaces**, click the name of the space.\n 2. In the Chat space's new message field, enter `@` and the name of the Chat app. Select your Chat app from the results\n 3. Press `Enter` or click send**Send**.\n 4. If the **Add to** space name window appears, click **Add to space**. Your message with the @mention is posted to the Chat space. A text also appears that explains that you added the Chat app to the space.\n\nYou can now test the Chat app in the space.\n\nWhen you test your Chat app, you should review all\nfeatures and then log and fix any errors that you encounter. To understand and\naddress any error messages, see [Troubleshoot and fix Google Chat\nerrors](/workspace/chat/troubleshoot).\n\nReview and test your Chat app for the Google Workspace Marketplace\n\nTo distribute and share a Chat app to anyone not\nlisted as a trusted tester, you must configure and publish the\nChat app to the Google Workspace Marketplace. For\ndetails, see [Publish apps to the Google Workspace Marketplace](/workspace/marketplace/how-to-publish).\n\nIf you want to publish your Chat app publicly on the\nGoogle Workspace Marketplace, you must submit your\nChat app for a review. Google reviews your\nChat app to make sure that it meets all\nMarketplace requirements. To learn about the process\nand requirements, see [App review process and requirements for the\nGoogle Workspace Marketplace](/workspace/marketplace/about-app-review).\n\nRelated topics\n\n- [Create and manage deployments for your Google Chat app](/workspace/chat/create-manage-deployments)\n- [Troubleshoot and fix Google Chat errors](/workspace/chat/troubleshoot-fix-chat-errors)\n- [Query error logs for Google Chat apps](/workspace/chat/query-logs)\n- [Publish apps to the Google Workspace Marketplace](/workspace/marketplace/how-to-publish)"]]
