Bu sayfada, Google Chat'i genişleten Google Workspace eklentilerinin nasıl oluşturulacağı hakkında genel bilgiler verilmektedir.
Chat'i genişleten Google Workspace eklentileri, kullanıcıların aşağıdakilerden herhangi birini yapmasına yardımcı olabilir:
- Chat mesajlarındaki bağlantıları önizleyebilir ve görüşmeden ayrılmadan işlem yapabilirsiniz.
- Google Workspace uygulamalarında görevleri otomatikleştirin veya gerçekleştirin.
- Kuruluş dışı araçlar veya hizmetlerle ilgili uyarılar ya da bildirimler alma
Google Workspace eklentilerinin Chat'te işleyiş şekli
Chat'te eklentiler kullanıcılara Google Chat uygulamaları olarak görünür. Chat uygulamaları, kullanıcılarla etkileşime geçmek için aşağıdakileri yapabilir:
- Metin, kart ve etkileşimli kullanıcı arayüzü öğeleri içeren mesajlar gönderin.
- Eğik çizgi komutlarını yanıtlayın.
- Kullanıcıların form verilerini doldurma gibi çok adımlı işlemleri tamamlamasına yardımcı olmak için iletişim kutuları açın.
- Kullanıcıların doğrudan sohbetten işlem yapmasına olanak tanıyan faydalı bilgiler içeren kartlar ekleyerek mesajlardaki bağlantıları önizleyin.
Başlayın
Chat'te çalışan Google Workspace eklentileri oluşturmaya başlamak için aşağıdaki dokümanlara göz atın:
- Google Apps Komut Dosyası veya HTTP hizmeti kullanarak temel bir Chat uygulaması oluşturmak için hızlı başlangıç kılavuzunu deneyin.
- Chat API'yi kullanarak Chat uygulamasını ve etkileşimli özelliklerini yapılandırın.
- Eklenti tetikleyicileri, işlemleri ve etkinlik nesnelerini kullanarak sohbet arayüzleri oluşturma hakkında bilgi edinin.
Sınırlamalar ve bilinen sorunlar
Aşağıdaki Sohbet ve eklenti özellikleri kullanılamaz:
- Dialogflow ve Pub/Sub. Apps Komut Dosyası'nı veya bir HTTP hizmetini kullanarak Chat'i genişleten eklentiler oluşturmanız gerekir.
- Apps Komut Dosyası'nın Kart Hizmeti. Sohbet işlemlerini kullanmak ve kart oluşturmak için bunun yerine JSON nesneleri döndürün. Örnekler için Etkileşimli iletişim kutularını açma ve Bağlantıları önizleme bölümlerine göz atın.
- Özel yetkilendirme kartları. Chat'ten hizmetinizin kimliğini doğrulamak ve hizmetinize yetki vermek için Chat uygulamasının temel yetkilendirme kartı döndürmesi gerekir.
- Chat kenar çubuğundaki eklenti ana sayfaları Eklentiniz için bir ana sayfa tetikleyicisi yapılandırdıysanız ana sayfa yalnızca eklentinizin genişlettiği diğer Google Workspace uygulamalarının kenar çubuğunda görünür.
- Chat uygulamasındaki doğrudan mesajların Ana Sayfa sekmesinde görünen Chat uygulaması ana sayfaları.
Mevcut bir Google Workspace eklentisini güncelliyorsanız Chat uygulamaları için aşağıdaki yapılandırma koşullarını göz önünde bulundurun:
- Google Workspace Marketplace yükleme ayarları, hem kullanıcıların hem de Google Workspace yöneticilerinin eklentiyi yüklemesine izin vermelidir.
- Eklentinin manifest dosyasında (
addons.common
) bulunan tüm genel yapılandırma ayarları Chat'te yoksayılır. Eklentiyi Chat'te çalışacak şekilde yapılandırmak için Chat API'yi etkinleştirmeniz ve yapılandırmanız gerekir. Adımlar için Google Chat uygulamasını yapılandırma başlıklı makaleyi inceleyin. - HTTP hizmetiyle oluşturma işlemi yapıyorsanız Google Workspace Add-ons API'yi etkinleştirmeniz gerekir.
deployment
veproject
REST kaynakları yalnızca diğer Google Workspace uygulamalarındaki eklenti dağıtımları için geçerlidir. - Chat'te bir eklentiyi dağıtmak ve test etmek için Chat API'nin Görünürlük ayarını kullanmanız gerekir. Google Workspace Marketplace SDK'sında yapılandırdığınız görünürlük veya test ayarları yoksayılır. Chat'te eklentinin test sürümünü dağıtmak için Chat API belgelerindeki Google Chat uygulamaları için etkileşimli özellikleri test etme bölümüne bakın.
- Eklentileriniz Google Workspace Marketplace'te yayınlanmışsa Google Chat API yapılandırma ayarlarında yapılan değişikliklerin taslağını kaydedemezsiniz. Chat API yapılandırma ayarlarını güncellediğinizde güncellenen Chat uygulaması mevcut tüm kullanıcıların kullanımına hemen sunulur. Marketplace girişinizi güncellemek için herhangi bir değişiklik göndermeden önce taslak oluşturabilirsiniz.