Bu sayfada, Google Chat uygulamanızla doğrudan mesajlar için nasıl ana sayfa oluşturacağınız açıklanmaktadır. Google Chat API'de uygulama ana sayfası olarak adlandırılan ana sayfa, bir kullanıcı ile Chat uygulaması arasındaki doğrudan mesaj alanlarının Ana Sayfa sekmesinde görünen özelleştirilebilir bir kart arayüzüdür.
Chat uygulamasıyla etkileşime geçmeyle ilgili ipuçları paylaşmak veya kullanıcıların Chat'ten harici bir hizmete veya araca erişip bu aracı kullanmasına izin vermek için uygulama ana sayfasını kullanabilirsiniz.
Chat uygulamaları için mesajlaşma ve kullanıcı arayüzlerini tasarlamak ve önizlemek üzere Kart Oluşturucu'yu kullanın:
Kart Oluşturucu'yu açınÖn koşullar
Node.js
Etkileşimli özellikler için etkinleştirilmiş bir Google Chat uygulaması. HTTP hizmetini kullanarak etkileşimli bir Chat uygulaması oluşturmak için bu hızlı başlangıç kılavuzunu tamamlayın.
Python
Etkileşimli özellikler için etkinleştirilmiş bir Google Chat uygulaması. HTTP hizmetini kullanarak etkileşimli bir Chat uygulaması oluşturmak için bu hızlı başlangıç kılavuzunu tamamlayın.
Java
Etkileşimli özellikler için etkinleştirilmiş bir Google Chat uygulaması. Bir HTTP hizmeti kullanarak etkileşimli Chat uygulaması için bu hızlı başlangıç kılavuzunu tamamlayın.
Apps Komut Dosyası
Etkileşimli özellikler için etkinleştirilmiş bir Google Chat uygulaması. Bir Apps Komut Dosyası'ndaki etkileşimli Chat uygulaması için bu hızlı başlangıç kılavuzunu tamamlayın.
Chat uygulamanız için uygulama ana sayfasını yapılandırın
Uygulama ana sayfasını desteklemek için Chat uygulamanızı APP_HOME
etkileşim etkinliklerini alacak şekilde yapılandırmanız gerekir. Chat uygulamanız, bir kullanıcı Chat uygulamasındaki doğrudan mesajdan Ana Sayfa sekmesini her tıkladığında bu etkinliği alır.
Google Cloud Console'da yapılandırma ayarlarınızı güncellemek için aşağıdakileri yapın:
Google Cloud konsolunda Menü'ye gidin. > Diğer ürünler > Google Workspace > Ürün Kitaplığı > Google Chat API'yi tıklayın.
Yönet'i ve ardından Yapılandırma sekmesini tıklayın.
Uygulama ana sayfasını yapılandırmak için Etkileşimli özellikler altındaki İşlevsellik bölümüne gidin:
- Bire bir mesajlar al onay kutusunu işaretleyin.
- Destek Uygulaması Ana Sayfası onay kutusunu işaretleyin.
Chat uygulamanız HTTP hizmeti kullanıyorsa şu sayfaya gidin: Bağlantı ayarlarını yapın ve Uygulama Ana Sayfa URL'si alanına girin. Google Etiket Yöneticisi'nde HTTP uç nokta URL'si alanına giriş yapın.
Kaydet'i tıklayın.
Uygulama ana sayfa kartı oluşturma
Kullanıcı uygulama ana ekranını açtığında Chat uygulamanız, pushCard
gezinme ve Card
içeren bir RenderActions
örneği döndürerek APP_HOME
etkileşim etkinliğini işlemelidir. Etkileşimli bir deneyim oluşturmak için kartta, Chat uygulamasının işleyip ek kartlarla veya bir iletişim kutusuyla yanıt verebileceği düğmeler ya da metin girişleri gibi etkileşimli widget'lar bulunabilir.
Aşağıdaki örnekte Chat uygulamasında Kartın oluşturulduğu zamanı gösteren ilk uygulama ana kartı bir düğme gibi. Kullanıcı düğmeyi tıkladığında Chat uygulaması değeri, güncellenen kartın oluşturulduğu zamanı gösteren güncellenmiş bir kart döndürür.
Node.js
Python
Java
Apps Komut Dosyası
Tüm APP_HOME
etkileşim etkinliklerinden sonra çağrılan onAppHome
işlevini uygulayın:
Bu örnek, kart JSON'unu döndürerek kart mesajı gönderir. Ayrıca şunu da kullanabilirsiniz: Apps Komut Dosyası kart hizmeti.
Uygulama ana ekranındaki etkileşimlere yanıt verme
İlk uygulama ana kartınız düğme veya seçim girişi gibi etkileşimli widget'lar içeriyorsa Chat uygulamanız, updateCard
gezinme özelliğiyle RenderActions
örneği döndürerek ilgili etkileşim etkinliklerini işlemelidir. Etkileşimli widget'ları işleme hakkında daha fazla bilgi edinmek için Kullanıcılar tarafından girilen bilgileri işleme başlıklı makaleyi inceleyin.
Yukarıdaki örnekte, ilk uygulama ana kartta bir düğme vardı. Her zaman
Kullanıcı düğmeyi tıkladığında, CARD_CLICKED
etkileşim etkinliği
gösterildiği gibi uygulama ana kartını yenilemek için updateAppHome
işlevini tetikler.
ile başlar:
Node.js
Python
Java
Apps Komut Dosyası
Bu örnek, kart JSON'unu döndürerek kart mesajı gönderir. Ayrıca şunu da kullanabilirsiniz: Apps Komut Dosyası kart hizmeti.
Açık iletişim kutuları
Chat uygulamanız, uygulama ana ekranında iletişim kutuları açarak da etkileşimlere yanıt verebilir.
Uygulama ana sayfasında iletişim kutusu açmak için ilgili etkileşim etkinliğini şu şekilde işleyin:
Card
içeren updateCard
gezinme içeren renderActions
döndürülüyor
nesnesini tanımlayın. Aşağıdaki örnekte, bir Chat uygulaması
CARD_CLICKED
işleyerek uygulama ana kartından bir düğme tıklamasına
etkileşim etkinliğini bulup bir iletişim kutusu açtığınızda:
{ renderActions: { action: { navigations: [{ updateCard: { sections: [{
header: "Add new contact",
widgets: [{ "textInput": {
label: "Name",
type: "SINGLE_LINE",
name: "contactName"
}}, { textInput: {
label: "Address",
type: "MULTIPLE_LINE",
name: "address"
}}, { decoratedText: {
text: "Add to favorites",
switchControl: {
controlType: "SWITCH",
name: "saveFavorite"
}
}}, { decoratedText: {
text: "Merge with existing contacts",
switchControl: {
controlType: "SWITCH",
name: "mergeContact",
selected: true
}
}}, { buttonList: { buttons: [{
text: "Next",
onClick: { action: { function: "openSequentialDialog" }}
}]}}]
}]}}]}}}
Bir iletişim kutusunu kapatmak için aşağıdaki etkileşim etkinliklerini işleyin:
CLOSE_DIALOG
: İletişim kutusunu kapatır ve Chat uygulamasının ilk uygulama ana kartı.CLOSE_DIALOG_AND_EXECUTE
: İletişim kutusunu kapatır ve uygulama ana sayfasını yeniler kartını inceleyebilirsiniz.
Aşağıdaki kod örneğinde, bir iletişim kutusunu kapatmak ve uygulama ana kartına dönmek için CLOSE_DIALOG
kullanılmaktadır:
{ renderActions: { action: {
navigations: [{ endNavigation: { action: "CLOSE_DIALOG" }}]
}}}
Kullanıcılardan bilgi toplamak için sıralı iletişim kutuları da oluşturabilirsiniz. Alıcı: sıralı iletişim kutuları oluşturmayı öğrenmek için İletişim kutularını açma ve yanıtlama.
İlgili konular
- Uygulama ana sayfasını kullanan Chat uygulama örneklerini görüntüleyin.
- İletişim kutularını açıp yanıt verebilirsiniz.