إنشاء عمليات نشر لتطبيق Google Chat وإدارتها
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح هذه الصفحة كيفية إنشاء عمليات نشر وإدارتها لتطبيق Google Chat. ومن خلال الحفاظ على عمليات نشر مختلفة، يمكنك إدارة كل مرحلة من مراحل دورة حياة تطبيق Chat بشكل أفضل وإصدار التغييرات في مرحلة الإنتاج بأمان.
إنشاء عمليات نشر لكل مرحلة من مراحل دورة حياة التطبيق
لإدارة تطبيق Chat طوال دورة حياته، ننصحك بإنشاء تطبيق Chat ونشره لكل من البيئات التالية:
- التطوير: البيئة التي تستخدمها لإجراء تغييرات. إذا
كنت بحاجة إلى ذلك، يمكنك استخدام عملية النشر الرئيسية أو تشغيل هذه البيئة محليًا.
- مرحلة الاختبار: هي البيئة التي يتم نشر التطبيق فيها للمختبِرين الموثوق بهم لإجراء اختبار شامل. يجب أن تكون هذه البيئة مشابهة لبيئة الإنتاج قدر الإمكان.
- بيئة الإنتاج: هي البيئة التي تنشر فيها تطبيقك للمستخدمين النهائيين من خلال نشر
تطبيق Chat على
Google Workspace Marketplace.
يجب إنشاء مشروع على Google Cloud لكل تطبيق تنشره في Chat. عند ضبط إعدادات Chat API في كل مشروع على السحابة الإلكترونية، ننصحك باستخدام اسم تطبيق مختلف وعنوان URL مختلف للصورة الرمزية ووصف مختلف، وذلك لتتمكّن من التمييز بشكل أفضل بين تطبيقات Chat في Google Chat.
في المثال التالي، تم إنشاء تطبيق Chat باسم Task app استنادًا إلى HTTP، ويستخدم نقاط نهاية مختلفة للنشر في بيئات التطوير والاختبار والإنتاج:
| البيئة |
اسم مشروع Cloud |
اسم التطبيق |
عنوان URL لنقطة نهاية HTTP |
| تطوير |
task-chat-app-dev |
تطبيق Dev Task |
http://example.com/api/myapp/head |
| تصنيف المراحل |
task-chat-app-staging |
تطبيق "اختبار التطبيق على مراحل" |
http://example.com/api/myapp/staging |
| الإنتاج |
task-chat-app |
تطبيق "مهام Google" |
http://example.com/api/myapp/ |
إدارة عمليات النشر استنادًا إلى بنية تطبيق Chat
يتضمّن الجدول التالي اعتبارات إضافية عند إدارة عمليات النشر
لبُنى تطبيقات الدردشة معيّنة:
| الهندسة المعمارية |
تنسيق النشر |
الاعتبارات |
| HTTP |
عنوان URL لنقطة نهاية HTTP |
- يمكنك نشر التغييرات بشكل تدريجي على كل نقطة نهاية في دورة حياة تطبيق Chat. على سبيل المثال، بعد اختبار ميزة جديدة تم نشرها في نقطة نهاية مرحلة الاختبار
http://example.com/api/myapp/staging، يمكنك طرح الميزة في مرحلة الإنتاج من خلال نشرها في نقطة نهاية مرحلة الإنتاج، مثل http://example.com/api/myapp.
- لتصحيح أخطاء الرمز قبل نشره، يمكنك ضبط نقطة نهاية في بيئتك المحلية. للتعرّف على كيفية اختبار التغييرات محليًا، يُرجى الاطّلاع على مقالة
تصحيح أخطاء تطبيقات Google Chat.
|
| لغة برمجة تطبيقات Google |
رقم تعريف النشر |
- يمكن أن تتضمّن مشاريع "برمجة التطبيقات" فرعًا واحدًا فقط، ويمكن ربطها بمشروع واحد على السحابة الإلكترونية. لاختبار التغييرات والحفاظ على بيئات متعددة، عليك إنشاء مشاريع مختلفة في "برمجة تطبيقات Google" لكل بيئة.
- يجب استخدام عملية نشر الإصدار الرئيسي من مشروع "برمجة تطبيقات Google" لبيئة التطوير فقط. بالنسبة إلى بيئات الإعداد والإنتاج، استخدِم عمليات النشر التي تتضمّن إصدارات. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة
إنشاء عمليات النشر وإدارتها
في مستندات Apps Script.
|
| نشر/اشتراك |
موضوع Pub/Sub |
يجب استخدام موضوع Pub/Sub مختلف لكل عملية نشر. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eManage your Google Chat app's lifecycle by creating separate deployments for development, staging, and production environments.\u003c/p\u003e\n"],["\u003cp\u003eCreate a distinct Google Cloud project for each deployment, using unique app names, avatar URLs, and descriptions for clarity.\u003c/p\u003e\n"],["\u003cp\u003eDeploy changes progressively through each environment, starting with development and moving to staging before releasing to production.\u003c/p\u003e\n"],["\u003cp\u003eFor Apps Script projects, maintain separate projects for each environment due to their single-branch limitation.\u003c/p\u003e\n"],["\u003cp\u003eUtilize different Pub/Sub topics for individual deployments to ensure environment isolation.\u003c/p\u003e\n"]]],["The document outlines creating and managing deployments for Google Chat apps across development, staging, and production environments. Each environment requires a separate Google Cloud project with a distinct app name and details. Deployment methods vary: HTTP uses endpoint URLs, Apps Script utilizes deployment IDs and separate projects, and Pub/Sub employs unique topics. Changes should be progressively deployed, starting from development, then staging, and finally production. Different app architectures require different consideration.\n"],null,["# Create and manage deployments for your Google Chat app\n\nThis page explains how to create and management deployments for your\nGoogle Chat app. By maintaining different deployments, you can\nbetter manage each phase of your Chat app's lifecycle\nand safely release changes to production.\n\nCreate deployments for each phase of the app lifecycle\n------------------------------------------------------\n\nTo manage your Chat app throughout its lifecycle, we\nrecommend that you create and deploy a Chat app for\neach of the following environments:\n\n- **Development:** The environment that you use to work on changes. If needed, you can use the head deployment or run this environment locally.\n- **Staging:** The environment that you deploy to trusted testers for end-to-end testing. This environment should be as close to production as possible.\n- **Production:** The environment that you deploy to end users by [publishing\n your Chat app to the\n Google Workspace Marketplace](/workspace/marketplace/how-to-publish).\n\nFor each Chat app that you deploy, you must create a\nGoogle Cloud project. When you configure the Chat API in each\nCloud project, consider using a distinct app name, avatar URL, and\ndescription so that you can better distinguish between the\nChat apps in Google Chat.\n\nIn the following example, the Chat app\ncalled `Task app` is built on HTTP and uses different endpoints to deploy to\ndevelopment, staging, and production:\n\n| Environment | Cloud project name | App name | HTTP endpoint URL |\n|-------------|-------------------------|------------------|----------------------------------------|\n| Development | `task-chat-app-dev` | Dev Task app | `http://example.com/api/myapp/head` |\n| Staging | `task-chat-app-staging` | Staging Task app | `http://example.com/api/myapp/staging` |\n| Production | `task-chat-app` | Task app | `http://example.com/api/myapp/` |\n\n### Manage deployments based on your Chat app architecture\n\nThe following table includes additional considerations when managing deployments\nfor specific [Chat app\narchitectures](/workspace/chat/structure):\n\n| Architecture | Deployment format | Considerations |\n|--------------------|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| HTTP | HTTP endpoint URL | - Deploy changes progressively to each endpoint in your Chat app's lifecycle. For example, after you've tested a new feature deployed in your staging endpoint `http://example.com/api/myapp/staging`, release the feature to production by deploying it to your production endpoint, such as `http://example.com/api/myapp`. - To debug code before deploying, you can set an endpoint to your local environment. To learn how to test changes locally, see [Debug Google Chat apps](/chat/troubleshoot/debug). |\n| Google Apps Script | Deployment ID | - Apps Script projects can only have a single branch and be associated with one Cloud project. To test changes and maintain multiple environments, you must create different Apps Script projects for each environment. - You should only use the Apps Script project's head deployment for the development environment. For staging and production environments, use versioned deployments. For details, see [Create and manage deployments](/apps-script/concepts/deployments) in the Apps Script documentation. |\n| Pub/Sub | Pub/Sub topic | You should use a different Pub/Sub topic for each deployment. |\n\nRelated topics\n--------------\n\n- [Test interactive features for Google Chat apps](/workspace/chat/test-interactive-features)\n- [Create and manage Apps Script deployments](/apps-script/concepts/deployments)\n- [Choose a Chat app architecture](/workspace/chat/structure)"]]
