Bu bölümde, Chat uygulamalarını geliştirirken ve test ederken karşılaşabileceğiniz yaygın sorunlar açıklanmaktadır.
Kart mesajı, iletişim kutusu veya bağlantı önizlemesi görüntülenmiyor ya da beklendiği gibi çalışmıyor
Kart hatalarını giderme konusunda yardım almak için Kartlarla ilgili sorunları giderme ve düzeltme başlıklı makaleyi inceleyin.
Uygulama yanıt vermiyor
Chat uygulamasına mesaj gönderdiğinizde "Uygulama yanıt vermiyor" cevabını alıyorsanız Chat uygulamasının yapılandırmasını doğrulayın:
Google Cloud konsolunda Menü'yü tıklayın. > Diğer ürünler > Google Workspace > Ürün Kitaplığı > Google Chat API > Yönet > Yapılandırma.
Uygulama durumu bölümünde Canlı - kullanıcılar tarafından kullanılabilir'i seçtiğinizden emin olun.
Etkileşimli özellikler bölümünde, ayarların uygulamanızın işlevine uygun olduğundan emin olun. Chat uygulamanız kullanıcılarla etkileşimde bulunuyorsa Etkileşimli özellikleri etkinleştir seçeneğini etkinleştirdiğinizden emin olun:
- Uygulamanız mesajlara yanıt veriyorsa Bire bir mesajlar al'ı seçtiğinizden emin olun.
- Bağlantı ayarları bölümünde Uygulama URL'si, Apps Komut Dosyası projesi Dağıtım Kimliği, Cloud Pub/Sub Konu Adı veya Dialogflow aracısının doğru şekilde ayarlandığından ve dağıtıldığından emin olun.
- Görünürlük bölümünde, uygun kullanıcıların uygulamaya e-posta adresi veya Google Workspace alanındaki bir grupla erişebildiğinden emin olun. Uygulama Google Workspace Marketplace SDK'sı ile dağıtıldıysa Google Workspace Marketplace ayarları öncelikli olduğundan görünürlük ayarları gerekli değildir.
Uygulama Google Workspace Marketplace SDK'sı ile yayınlandıysa Google Workspace Marketplace ayarlarını inceleyin.
Kaydet'i tıklayın.
Uygulamayla tekrar mesajlaşmayı deneyin.
Google Chat API yalnızca Google Workspace kullanıcıları tarafından kullanılabilir
Chat uygulamasını yapılandırırken
hata Google Chat API is only available to Google Workspace users. Bu mesaj
yapılandırma sırasında kullandığınız Google Hesabı
Chat API, bir Google Workspace kuruluşunun parçası değildir. Bir
Chat uygulamasını veya Chat API'yi kullanmak için
Google Workspace
hesap.
Google Chat kullanıcılarının Chat uygulamalarını Google Workspace hesabı. Kullanıcıların uygulamayı nasıl keşfettiği ve yüklediği hakkında daha fazla bilgi edinmek için Sohbet uygulamaları için Yayınlama başlıklı makaleye göz atın. Google Chat uygulamaları.
Kullanıcılar alanlardan hariç tutulabilir
Google Workspace yöneticisi kullanıcıların Sohbet geçmişini etkinleştirmesine veya devre dışı bırakmasına izin vermiyorsa kullanıcıların sohbet geçmişini açık veya kapalı olarak zorunlu kılan kullanıcı düzeyindeki bir ayar ile kuruluş düzeyindeki zorunlu ayarı devralan alan arasındaki çakışma nedeniyle kullanıcıların bir alana katılamadığı ya da bir alanda kalamadığı durumlarla karşılaşabilirsiniz.
Örneğin, bir kullanıcının Sohbet geçmişi ayarı zorunlu olarak "açık" ise Bir alanın Chat geçmişi ayarı "kapalı" ise kullanıcı alana katılamayabilir. Ayrıca, çakışmadan önce katılan ve çakışmadan sonra alanda bir mesaj yayınlayan kullanıcı alandan çıkarılabilir.
Bu senaryoda ve geçmiş ayarları arasında çakışmaların olduğu diğer senaryolarda Chat API üyelik oluşturamayabilir veya kullanıcı kimlik doğrulaması içeren bir mesaj oluşturduğunuzda, çakışan bir Chat geçmişi ayarına sahip kimliği doğrulanmış kullanıcıyı alandan kaldırabilir.
Daha fazla bilgi edinmek için Google Workspace Yönetici Yardım Merkezi'ndeki Kullanıcılar alanlardan hariç tutulabilir başlıklı makaleyi inceleyin.
Google Apps Komut Dosyası'ndaki Gelişmiş Sohbet hizmetiyle ilgili sorunları giderme
Şu komutla ilgili Apps Komut Dosyası sayfasına bakın: Gelişmiş Chat Hizmeti.
Kullanıcılar bir alana Chat uygulaması ekleyemez
Kullanıcılar hata mesajıyla karşılaşırsa
This organization's administrator must allow users to install this Chat app.
Bir alana Chat uygulaması eklenmeye çalışılırken bu hata oluştu
bunun nedeni aşağıdakilerden biri olabilir:
- Kuruluş, Chat uygulamalarını devre dışı bıraktı.
- Kuruluş bu belirli ayarı eklemedi Chat uygulamasını kuruluşun izin verilenler listesine ekleyin.
Kullanıcı bir Chat uygulaması (kuruluştan kaynaklanıyor olabilir) bir alt kuruluş birimi için etkinleştirilmeden, söz konusu kuruluş birimine erişim üst kuruluş birimi.
Bu sorunun çözümüyle ilgili bilgi için bkz. Kullanıcıların Chat uygulamalarını yüklemesine izin verin.
Cloud Functions işlevi hatalarını giderme
Chat uygulaması, Cloud Functions ve çalışmıyorsa aşağıdaki bölümler sorunu gidermeye ve düzeltmeye yardımcı olur.
Cloud Functions işlevi günlüklerini kontrol etme
İlk adım olarak Cloud Functions günlüklerinde hata olup olmadığını kontrol edin.
Google Cloud Console'da Cloud Functions sayfasına gidin:
Günlükleri açmak için Chat uygulamanızın Cloud işlevi, ardından İşlemleri göster > Günlükleri görüntüle'yi tıklayın.
Günlük Gezgini, aşağıdakiler dahil olmak üzere Cloud Functions işlevlerini gösteren bir sorguyu açar ve çalıştırır: hatalar.
Kaydedilen varsayılan bilgiler uygulamanızda hata ayıklamak için yeterli olmuyorsa Cloud Functions işlevi kodunuzdan ek günlük kaydı oluşturun. Cloud'u görüntüleme ve yazma İşlev günlükleri.
Cloud Functions işlevi hatalarını kontrol etme
Cloud Functions işlevi, günlüklerin yanı sıra çalışıyor.
Google Cloud Console'da Cloud Functions sayfasına gidin:
Chat uygulamanızda Cloud Functions işlevini tıklayın.
İşlev ayrıntıları sayfasında, hatalar Hatalar başlığı altında listelenir.
Daha ayrıntılı sorun giderme adımları için ilgili hatayı tıklayın.
Yaygın Cloud Functions işlevi hatalarını düzeltme
Bir projeyi oluştururken bazen aşağıdaki hatalarla karşılaşılır Cloud Functions ile Chat uygulaması
PROJECT_NAME projesindeki REGION_NAME bölgesinde yer alan ChatApp işlevi zaten mevcut
Bir Cloud Functions işlevini dağıtırken Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists hatası alabilirsiniz. Bu mesaj, başka bir Cloud Functions işlevinin
bir hiyerarşiye değineceğiz. Adı değiştirin ve
fonksiyonu yeniden dağıtın. Chat uygulamasının
Cloud Functions işlevinizin tetikleyicisi olmalıdır.
Politikada adı geçen bir veya daha fazla kullanıcı, izin verilen bir müşteriye ait değil
Bir Cloud Functions işlevi dağıtırken The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer." hatası alabilirsiniz. Bu hatayı alırsanız ve
Google Chat uygulamasında uygulamanın yanıt vermediğini belirten bir hata alırsınız.
Chat, Cloud Functions işlevini barındıran sunucuya erişemiyor. Bu mesajın anlamı,
"allUsers" adlı bir kullanıcı Cloud Functions işlevini çağırma izni yok.
"allUsers" ifadesini ekleme "Cloud Functions Çağırıcısı" rolünün, Bulut Bilişim
Uygulamayı destekleyen işlev herkese açık ve erişilebilirdir.
kimlik doğrulama. Rollerin nasıl atanacağını öğrenmek için
Tek bir rol verin.
Bu hata, Google Cloud projesinin alanla sınırlı olduğu anlamına gelebilir. Örneğin, alan kısıtlaması kısıtlamaları hakkında daha fazla bilgi için Kimlikleri alana göre kısıtlama.
Bu sorunu çözmek için Cloud Functions işlevinizin kimlik doğrulaması yapmaya izin verdiğinden emin olun çağrı sayısı. Mevcut bir Cloud Functions işlevi için Herkese açık (kimliği doğrulanmamış) erişime izin verme.