ویژگی‌های تعاملی را برای برنامه‌های Google Chat آزمایش کنید، ویژگی‌های تعاملی را برای برنامه‌های Google Chat آزمایش کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این صفحه نحوه پیکربندی و نصب نسخه آزمایشی برنامه Google Chat را توضیح می‌دهد تا بتوانید ویژگی‌های تعاملی - مانند دستورات برنامه چت ، پیام‌رسانی مستقیم و پیش‌نمایش پیوندها - را قبل از انتشار آن‌ها برای کاربران نهایی امتحان کنید.
با آزمایش برنامه Chat خود، می توانید مطمئن شوید که تجربه کاربری با کیفیت بالا و عملکردهای مورد انتظار را ارائه می دهد. اگر برنامه Chat خود را به صورت عمومی منتشر می کنید، آزمایش به شما کمک می کند مطمئن شوید که برنامه Chat شما شرایط لازم برای فهرست شدن در Google Workspace Marketplace را دارد.
برای آزمایش ایمن در هر مرحله از چرخه عمر برنامه Chat، توصیه می‌کنیم محیط‌های جداگانه‌ای را برای توسعه، مرحله‌بندی و تولید تنظیم کنید. در هر محیط، باید یک برنامه Chat متفاوت ایجاد و اجرا کنید. برای آشنایی با نحوه راه‌اندازی محیط‌ها، به ایجاد و مدیریت استقرارها برای برنامه گپ Google خود مراجعه کنید.
پیش نیازها
یک برنامه Google Chat که برای دریافت و پاسخگویی به رویدادهای تعامل پیکربندی شده است. برای ایجاد یک برنامه چت تعاملی، یکی از شروع سریع زیر را بر اساس معماری برنامه ای که می خواهید استفاده کنید، انجام دهید:
هر کسی که برنامه Chat را آزمایش می‌کند باید متعلق به همان سازمان Google Workspace باشد که برنامه گپ شما در آن پیکربندی شده است.
مطمئن شوید که به آزمایش و نصب برنامه Chat در سازمان Google Workspace خود دسترسی دارید. برای جزئیات، به پیکربندی دسترسی برای سازمان‌های Google Workspace در اسناد Google Workspace Marketplace مراجعه کنید.
آزمایش‌کنندگان مورد اعتماد را اضافه کنید
برای برنامه‌های چت تعاملی، Chat API به شما امکان می‌دهد برنامه گپ خود را با افراد خاصی در سازمان Google Workspace خود به اشتراک بگذارید. افرادی که مشخص می‌کنید می‌توانند برنامه Chat را به یک فضا اضافه کنند و ویژگی‌های آن را قبل از انتشار آن در Marketplace آزمایش کنند. برای آزمایش برنامه چت خود، باید خود را به عنوان آزمایش‌کننده مورد اعتماد اضافه کنید.
برای در دسترس قرار دادن برنامه Chat آزمایشی خود برای شما و سایرین در سازمانتان، تنظیمات Chat API Visibility را در کنسول Google Cloud به‌روزرسانی کنید:
در کنسول Google Cloud، صفحه Google Chat API را باز کنید:
به ویژگی‌های تعاملی > نمایان بودن بروید و سپس برنامه این گپ را در دسترس افراد و گروه‌های خاص در GOOGLE_WORKSPACE_ORGANIZATION انتخاب کنید، جایی که GOOGLE_WORKSPACE_ORGANIZATION نام سازمان شما است.
در فیلدی که پس از انتخاب چک باکس ظاهر می‌شود، آدرس ایمیل افراد یا گروه‌های Google که می‌خواهید به برنامه چت خود دسترسی داشته باشند را وارد کنید، که با کاما از هم جدا شده‌اند. برای آزمایش برنامه چت خود، آدرس ایمیلی را که برای دسترسی به Google Chat استفاده می‌کنید وارد کنید.
روی ذخیره کلیک کنید.
برنامه چت خود را به فضاها اضافه کنید
برای شروع آزمایش ویژگی‌های تعاملی، باید برنامه چت خود را به یک یا چند فضا، مانند پیام مستقیم، پیام گروهی یا فضای نام‌گذاری شده اضافه کنید. اگر همه اعضای فضا را به‌عنوان آزمایش‌کننده معتمد اضافه نکرده‌اید، ممکن است بتوانند برنامه Chat را در فضا ببینند اما نمی‌توانند مستقیماً با آن تعامل داشته باشند.
برنامه‌های گپی که منتشر نشده‌اند در نتایج فهرست‌بندی Google Workspace Marketplace ظاهر نمی‌شوند. برای یافتن برنامه‌های Chat منتشر نشده در Google Chat، می‌توانید برنامه Chat را جستجو کنید، آن را در ابزارهای Google Workspaceadd_circle_outline در حین نوشتن پیام بیابید، یا در پیامی از برنامه Chat @ نام ببرید.
برای افزودن برنامه چت خود به یک فضا، موارد زیر را انجام دهید:
Google Chat را با استفاده از حساب Google Workspace که هنگام اضافه کردن خود به عنوان آزمایش‌کننده معتمد ارائه کرده‌اید، باز کنید.
برای شروع یک پیام مستقیم با برنامه چت، موارد زیر را انجام دهید:
addگپ جدید کلیک کنید.
در قسمت افزودن 1 یا چند نفر ، نام برنامه چت خود را تایپ کنید.
برنامه چت خود را از نتایج انتخاب کنید. یک پیام مستقیم باز می شود.
برای افزودن برنامه چت به فضای موجود، موارد زیر را انجام دهید:
در قسمت Spaces ، روی نام فضا کلیک کنید.
در قسمت پیام جدید فضای چت، @ و نام برنامه چت را وارد کنید. برنامه چت خود را از نتایج انتخاب کنید
Enter فشار دهید یا روی ارسالsend کنید.
اگر پنجره Add to space name ظاهر شد، روی Add to space کلیک کنید. پیام شما با نام @ در فضای چت پست می شود. همچنین متنی ظاهر می‌شود که توضیح می‌دهد برنامه چت را به فضا اضافه کرده‌اید.
اکنون می توانید برنامه Chat را در فضا آزمایش کنید.
هنگامی که برنامه چت خود را آزمایش می‌کنید، باید همه ویژگی‌ها را بررسی کنید و سپس خطاهایی را که با آن مواجه می‌شوید ثبت و برطرف کنید. برای درک و رفع هرگونه پیام خطا، به عیب‌یابی و رفع خطاهای Google Chat مراجعه کنید.
برنامه Chat خود را برای Google Workspace Marketplace مرور و آزمایش کنید
برای توزیع و اشتراک‌گذاری یک برنامه گپ برای افرادی که به‌عنوان آزمایش‌کننده معتمد فهرست نشده‌اند، باید برنامه چت را در Google Workspace Marketplace پیکربندی و منتشر کنید. برای جزئیات، به انتشار برنامه‌ها در Google Workspace Marketplace مراجعه کنید.
اگر می‌خواهید برنامه چت خود را به صورت عمومی در Google Workspace Marketplace منتشر کنید، باید برنامه چت خود را برای بررسی ارسال کنید. 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)"]]
