Google Chat uygulamaları için etkileşimli özellikleri test etme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, Google Chat uygulamanızın test sürümünü nasıl yapılandırıp yükleyeceğiniz açıklanmaktadır. Böylece, son kullanıcılara sunmadan önce Chat uygulaması komutları, doğrudan mesajlaşma ve bağlantı önizlemeleri gibi etkileşimli özellikleri deneyebilirsiniz.
Chat uygulamanızı test ederek yüksek kaliteli bir kullanıcı deneyimi sunduğundan ve beklendiği gibi çalıştığından emin olabilirsiniz. Chat uygulamanızı herkese açık olarak yayınlıyorsanız test, Chat uygulamanızın Google Workspace Marketplace'te listelenme şartlarını karşıladığından emin olmanıza da yardımcı olur.
Chat uygulamanızın yaşam döngüsünün her aşamasında güvenli bir şekilde test yapmak için geliştirme, hazırlık ve üretim için ayrı ortamlar oluşturmanızı öneririz. Her ortamda farklı bir Chat uygulaması oluşturup dağıtmanız gerekir. Ortamları nasıl ayarlayacağınızı öğrenmek için Google Chat uygulamanız için dağıtımlar oluşturma ve yönetme başlıklı makaleyi inceleyin.
Ön koşullar
Etkileşim etkinliklerini alıp bunlara yanıt verecek şekilde yapılandırılmış bir Google Chat uygulaması. Etkileşimli bir Chat uygulaması oluşturmak için kullanmak istediğiniz uygulama mimarisine göre aşağıdaki hızlı başlangıçlardan birini tamamlayın:
Chat uygulamasını test eden herkes, Chat uygulamanızın yapılandırıldığı Google Workspace kuruluşuna ait olmalıdır.
Google Workspace kuruluşunuzda Chat uygulamasını test etme ve yükleme erişiminizin olduğundan emin olun. Ayrıntılar için Google Workspace Marketplace belgelerindeki Google Workspace kuruluşları için erişimi yapılandırma başlıklı makaleyi inceleyin.
Güvenilen test kullanıcıları ekleme
Etkileşimli Chat uygulamaları için Chat API, Chat uygulamanızı Google Workspace kuruluşunuzdaki belirli kişilerle paylaşmanıza olanak tanır. Belirttiğiniz kişiler, Chat uygulamasını bir alana ekleyebilir ve Marketplace'te yayınlamadan önce özelliklerini test edebilir. Kendi Chat uygulamanızı test etmek için kendinizi güvenilir test kullanıcısı olarak eklemeniz gerekir.
Test Chat uygulamanızı kendinizin ve kuruluşunuzdaki diğer kullanıcıların kullanımına sunmak için Google Cloud Console'da Chat API Görünürlük ayarını güncelleyin:
Google Cloud Console'da Google Chat API sayfasını açın:
Etkileşimli özellikler > Görünürlük'e gidin ve Bu Sohbet uygulamasını GOOGLE_WORKSPACE_ORGANIZATION kuruluşundaki belirli kişiler ve gruplar için kullanılabilir hale getir'i seçin. GOOGLE_WORKSPACE_ORGANIZATION, kuruluşunuzun adıdır.
Onay kutusunu işaretledikten sonra görünen alana, Chat uygulamanıza erişmesini istediğiniz kişilerin veya Google Grupları'nın e-posta adreslerini virgülle ayırarak girin. Kendi Chat uygulamanızı test etmek için Google Chat'e erişmek üzere kullandığınız e-posta adresini girin.
Kaydet'i tıklayın.
Chat uygulamanızı alanlara ekleme
Etkileşimli özellikleri test etmeye başlamak için Chat uygulamanızı bir veya daha fazla alana (ör. doğrudan mesaj, grup mesajı veya adlandırılmış alan) eklemeniz gerekir. Alanın tüm üyelerini güvenilir test kullanıcıları olarak eklemediyseniz bu üyeler alandaki Chat uygulamasını görebilir ancak doğrudan etkileşimde bulunamaz.
Yayınlanmamış Chat uygulamaları, Google Workspace Marketplace'teki listeleme sonuçlarında görünmez. Google Chat'te yayınlanmamış Chat uygulamalarını bulmak için Chat uygulamasını arayabilir, mesaj oluştururken
add_circle_outline Google Workspace araçları bölümünde bulabilir veya mesajda Chat uygulamasından @bahsedebilirsiniz.
Chat uygulamanızı bir alana eklemek için aşağıdakileri yapın:
Kendinizi güvenilir test kullanıcıları arasına eklerken sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.
Chat uygulamasıyla doğrudan mesaj başlatmak için aşağıdakileri yapın:
addYeni sohbet'i tıklayın.
1 veya daha fazla kişi ekle alanına Chat uygulamanızın adını yazın.
Sonuçlardan Chat uygulamanızı seçin. Doğrudan mesaj açılır.
Chat uygulamasını mevcut bir alana eklemek için aşağıdakileri yapın:
Alanlar bölümünde alanın adını tıklayın.
Chat alanı yeni mesaj alanına @ ve Chat uygulamasının adını girin. Sonuçlar arasından Chat uygulamanızı seçin.
Enter tuşuna basın veya send Gönder'i tıklayın.
Ekle alan adı penceresi görünürse Alana ekle'yi tıklayın. @bahsetme içeren mesajınız Chat alanında yayınlanır.
Ayrıca, Chat uygulamasını alana eklediğinizi açıklayan bir metin de gösterilir.
Artık alandaki Chat uygulamasını test edebilirsiniz.
Chat uygulamanızı test ederken tüm özellikleri incelemeli, ardından karşılaştığınız hataları günlüğe kaydetmeli ve düzeltmelisiniz. Hata mesajlarını anlayıp gidermek için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.
Google Workspace Marketplace için Chat uygulamanızı inceleme ve test etme
Güvenilir test kullanıcıları arasında yer almayan kişilerle Chat uygulaması dağıtmak ve paylaşmak için Chat uygulamasını Google Workspace Marketplace'te yapılandırıp yayınlamanız gerekir. Ayrıntılar için Google Workspace Marketplace'te uygulama yayınlama başlıklı makaleyi inceleyin.
Chat uygulamanızı Google Workspace Marketplace'te herkese açık olarak yayınlamak istiyorsanız Chat uygulamanızı incelemeye göndermeniz gerekir. Google, Chat uygulamanızın tüm Marketplace şartlarını karşıladığından emin olmak için uygulamayı inceler. Süreç ve şartlar hakkında bilgi edinmek için Google Workspace Marketplace için uygulama inceleme süreci ve şartları başlıklı makaleyi inceleyin.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-04 UTC."],[[["\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)"]]
