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 beklendiği gibi oluşturulmuyor veya çalışmıyor
Kart hatalarını giderme konusunda yardım almak için Kartlarla ilgili sorunları giderme ve düzeltme konusuna bakın.
Uygulama yanıt vermiyor
Chat uygulamasına mesaj gönderirseniz ve uygulama "Uygulama yanıt vermiyor" yanıtını verirse Chat uygulamasının yapılandırmasını doğrulayın:
Google Cloud Console'da Menü > Diğer ürünler > Google Workspace > Ürün Kitaplığı > Google Chat API > Yönet > Yapılandırma'yı tıklayın.
Uygulama durumu bölümünde Yayında - kullanıcılara açık'ı 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 1:1 mesajları al'ı seçtiğinizden emin olun.
- Bağlantı ayarları bölümünde Uygulama URL'si, Apps Komut Dosyası projesinin Dağıtım Kimliği, Cloud Pub/Sub Konu Adı veya Dialogflow aracısının doğru ayarlandığından ve dağıtıldığından emin olun.
- Görünürlük bölümünde, uygun kullanıcıların e-posta adresi veya Google Workspace alanında bir grupla uygulamaya erişebildiğinden emin olun. Uygulama Google Workspace Marketplace SDK 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 ile yayınlandıysa Google Workspace Marketplace ayarlarını inceleyin.
Kaydet'i tıklayın.
Uygulamayla tekrar mesajlaşmayı deneyin.
Google Chat API'den yalnızca Google Workspace kullanıcıları yararlanabilir
Chat uygulamasını yapılandırırken Google Chat API is only available to Google Workspace users hatası alabilirsiniz. Bu mesaj, Chat API'yi yapılandırmak için kullandığınız Google Hesabı'nın bir Google Workspace kuruluşuna ait olmadığı anlamına gelir. Chat uygulaması oluşturmak veya Chat API'yi kullanmak için bir Google Workspace hesabı kullanmanız gerekir.
Google Chat kullanıcılarının, Google Workspace hesabı olmadan Chat uygulamalarını kullanabileceğini unutmayın. Kullanıcıların Chat uygulamalarını nasıl keşfedip yüklediği hakkında daha fazla bilgi edinmek için Google Chat uygulamalarını yayınlama başlıklı makaleyi inceleyin.
Kullanıcılar alanlardan hariç tutulabilir
Bir Google Workspace yöneticisi kullanıcıların Chat geçmişini etkinleştirmesine veya devre dışı bırakmasına izin vermiyorsa kullanıcıların sohbet geçmişini etkinleştirme veya devre dışı bırakmaya zorlayan kullanıcı düzeyindeki ayar ile kuruluş düzeyinde zorunlu ayarı devralan bir alan arasındaki çakışma nedeniyle kullanıcılar bir alana katılamaz ya da bir alanda kalamaz.
Örneğin, bir kullanıcının Chat geçmişi ayarının "açık" olması ve bir alanın Chat geçmişi ayarının "kapalı" olması zorunlu kılındıysa bu kullanıcı alana katılamayabilir. Ayrıca, çakışmadan önce katılan ve çakışmanın ardından alanda mesaj yayınlayan kullanıcılar 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şturmak, çakışan bir Chat geçmişi ayarına sahip kimliği doğrulanmış kullanıcıyı alandan çıkarabilir.
Daha fazla bilgi edinmek için Google Workspace Yöneticisi Yardım Merkezi'nde Kullanıcılar alanlardan hariç tutulabilir başlıklı makaleyi inceleyin.
Google Apps Komut Dosyası'ndaki Gelişmiş Sohbet hizmetiyle ilgili sorunları giderme
Gelişmiş Chat Hizmeti ile ilgili Apps Komut Dosyası sayfasına göz atın.
Kullanıcılar bir alana Chat uygulaması ekleyemiyor
Kullanıcılar bir alana Chat uygulaması eklemeye çalışırken
This organization's administrator must allow users to install this Chat app
hata mesajıyla karşılaşırsa bu hatanın nedeni aşağıdakilerden biri olabilir:
- Kuruluş, Chat uygulamalarını devre dışı bıraktı.
- Kuruluş, söz konusu Chat uygulamasını kuruluşun izin verilenler listesine eklemedi.
Kullanıcı bir Chat uygulamasıyla etkileşimde bulunmaya çalışırken bu hata mesajıyla karşılaşırsa bunun nedeni, kuruluşun üst kuruluş birimi için etkinleştirmeden bir alt kuruluş birimine erişim izni vermesi olabilir.
Bu sorunun çözümüyle ilgili bilgi edinmek için Kullanıcıların Chat uygulamalarını yüklemesine izin verme başlıklı makaleyi inceleyin.
Cloud Functions işlevi hatalarını giderme
Chat uygulaması Cloud Functions ile uygulanmışsa ve çalışmıyorsa aşağıdaki bölümler, sorunu gidermenize ve düzeltmenize yardımcı olur.
Cloud Functions işlevlerini kontrol edin
İlk adım olarak, Cloud Functions günlüklerinde hata olup olmadığını kontrol edin.
Google Cloud konsolunda Cloud Functions sayfasına gidin:
Günlükleri açmak için Chat uygulamanızın Cloud Functions işlevini bulun ve İşlemleri göster > Günlükleri göster'i tıklayın.
Günlük Gezgini, Cloud Functions işlevi günlüklerini hatalar dahil olmak üzere gösteren bir sorguyu açar ve çalıştırır.
Günlüğe kaydedilen varsayılan bilgiler uygulamanızda hata ayıklamak için yeterli olmuyorsa Cloud Functions işlevi kodunuzdan ek günlük kaydı ekleyebilirsiniz. Cloud Functions günlüklerini görüntüleme ve yazma bölümünü inceleyin.
Cloud Functions işlevi hatalarını kontrol etme
Cloud Functions işlevi, günlüklerin yanı sıra çalışırken karşılaşılan hataları da raporlayabilir.
Google Cloud konsolunda Cloud Functions sayfasına gidin:
Chat uygulamanızın Cloud Functions işlevini tıklayın.
İşlev ayrıntıları sayfasındaki hatalar, Hatalar bölümünde listelenir.
Bir hatayı daha ayrıntılı bir şekilde gidermek için ilgili hatayı tıklayın.
Sık karşılaşılan Cloud Functions işlevlerini düzeltme
Cloud Functions ile Chat uygulaması derlenirken bazen aşağıdaki hatalarla karşılaşılır.
PROJECT_NAME projesindeki REGION_NAME bölgesinde ChatApp işlevi zaten mevcut
Cloud Functions işlevi 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 dağıttığınız ada sahip olduğu anlamına gelir. Adı değiştirin ve işlevi tekrar dağıtın. Chat uygulamasının, önceden mevcut olan Cloud Functions işlevinin Tetikleyici URL'sini değil, Cloud Functions işleviniz için Tetikleyici URL'sini kullandığını doğrulayın.
Politikada adı geçen bir veya daha fazla kullanıcı, izin verilen bir müşteriye ait değil
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ır ve Chat uygulamasına mesaj gönderirseniz Google Chat, Cloud Functions işlevini barındıran sunucuya erişemediği için uygulamanın yanıt vermediğini belirten bir hata mesajı alırsınız. Bu mesaj, "allUsers" adlı kullanıcının Cloud Functions işlevini çağırma izni olmadığı anlamına gelir.
"allUsers"a "Cloud Functions Çağırıcısı" rolünü vermek, uygulamayı destekleyen Cloud Functions işlevinin herkese açık olduğu ve kimlik doğrulaması gerekmeden erişilebildiği anlamına gelir. Nasıl rol atayacağınızı öğrenmek için Tek bir rol atama sayfasına göz atın.
Bu hata, Google Cloud projesinin alanla kısıtlı olduğu anlamına gelebilir. Alan kısıtlaması kısıtlamaları hakkında daha fazla bilgi için Kimlikleri alana göre kısıtlama bölümüne bakın.
Bu sorunu çözmek için Cloud Functions işlevinizin kimliği doğrulanmamış çağrılara izin verdiğini doğrulayın. Mevcut bir Cloud Functions işlevi için kimliği doğrulanmamış çağrılara nasıl izin vereceğinizi öğrenmek istiyorsanız Herkese açık (kimliği doğrulanmamış) erişime izin verme bölümüne bakın.