Bu bölümde, Chat uygulamaları oluştururken ve test ederken karşılaşabileceğiniz yaygın sorunlar açıklanmaktadır.
Kart mesajı, iletişim kutusu veya bağlantı önizlemesi oluşturulmuyor ya da beklendiği gibi çalışmıyor
Kart hatalarını giderme konusunda yardım 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" yanıtını alırsanız 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'si > Yönet > Yapılandırma'yı tıklayın.
Uygulama durumu bölümünde Yayınlandı - 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şlevselliğine uygun olduğundan emin olun. Chat uygulamanız kullanıcılarla etkileşim kuruyorsa Etkileşimli özellikleri etkinleştir'i açtığınızdan emin olun:
- Uygulamalar, varsayılan olarak kullanıcılardan gelen doğrudan mesajları yanıtlayabilir.
- Uygulamanız alanlardaki ve grup sohbetlerindeki mesajlara yanıt veriyorsa Alanlara ve grup görüşmelerine katıl'ı seçin.
- Bağlantı ayarları bölümünde HTTP uç noktası URL'sinin, Apps Komut Dosyası projesi Dağıtım Kimliği'nin, Cloud Pub/Sub Konu Adı'nın 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 e-posta adresi veya Google Workspace alanındaki bir grup aracılığıyla uygulamaya erişebildiğinden emin olun. Uygulama Google Workspace Marketplace SDK ile dağıtılıyorsa 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.
Uygulamaya tekrar mesaj göndermeyi deneyin.
Google Chat API yalnızca Google Workspace kullanıcılarına sunulur
Chat uygulamasını yapılandırırken Google Chat API is only available to Google Workspace users hatasını alabilirsiniz. Bu mesaj, Chat API'yi yapılandırmak için kullandığınız Google Hesabı'nın bir Google Workspace kuruluşunun parçası olmadığını gösterir. Chat uygulaması oluşturmak veya Chat API'yi kullanmak için Google Workspace hesabınızın olması gerekir.
Google Chat kullanıcılarının Chat uygulamalarını Google Workspace hesabı olmadan 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 Etkileşimli Google Chat uygulamaları oluşturma başlıklı makaleyi inceleyin.
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, sohbet geçmişini etkinleştirmeyi veya devre dışı bırakmayı zorunlu kılan kullanıcı düzeyindeki bir ayarla kuruluş düzeyinde zorunlu kılınan ayarı devralan bir alan arasındaki çakışma nedeniyle kullanıcıların bir alana katılamadığı veya alanda kalamadığı durumlar olabilir.
Örneğin, bir kullanıcının sohbet geçmişi ayarı zorunlu olarak "açık" ve bir alanın sohbet geçmişi ayarı zorunlu olarak "kapalı" ise kullanıcı alana katılamayabilir. Ayrıca, bu kullanıcı çakışmadan önce alana katıldıysa ve çakışmadan sonra alana mesaj gönderirse alandan kaldırı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ıyla mesaj oluşturmak, çakışan bir Chat geçmişi ayarına sahip kimliği doğrulanmış kullanıcıyı alandan kaldırabilir.
Daha fazla bilgi için Google Workspace Yöneticisi Yardım Merkezi'ndeki Kullanıcılar alanlardan hariç tutulabilir başlıklı makaleyi inceleyin.
Google Apps Komut Dosyası'ndaki Advanced Chat hizmetiyle ilgili sorunları giderme
İleri Chat Hizmeti hakkında bilgi edinmek için Apps Komut Dosyası sayfasını inceleyin.
Kullanıcılar alanlara 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şıyorsa bu hatanın nedeni aşağıdakilerden biri olabilir:
- Kuruluş, Chat uygulamalarını devre dışı bırakmıştır.
- Kuruluş, bu Chat uygulamasını kuruluşun izin verilenler listesine eklememiştir.
Bir kullanıcı, Chat uygulamasıyla etkileşim kurmaya çalışırken bu hata mesajıyla karşılaşıyorsa bunun nedeni, kuruluşun üst kuruluş birimi için etkinleştirmeden alt kuruluş birimine erişim izni vermesi olabilir.
Bu sorunu çözme hakkında bilgi edinmek için Kullanıcıların Chat uygulamalarını yüklemesine izin verme başlıklı makaleyi inceleyin.
Yöneticinin, bu işlem için uygulamaya gerekli OAuth yetkilendirme kapsamını vermesi gerekir.
Chat uygulaması olarak kimlik doğrulaması yaparken aşağıdaki hatayı alabilirsiniz:
<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">
Bu hata mesajı, bir Google Workspace yöneticisinin, https://www.googleapis.com/auth/chat.app.* adıyla başlayan yetkilendirme kapsamlarını kullanmak için Chat uygulamasına henüz tek seferlik onay vermediği anlamına gelir.
Hatayı düzeltmek için:
- Google Workspace yöneticisinden Chat uygulamanız için onay vermesini isteyin.
Chat uygulamanızın mantığında bu hatayı işlerken,
istenen işlemi gerçekleştirmek için Chat uygulamasının yönetici onayı alması gerektiğini duyuran bir mesaj göndermeyi düşünebilirsiniz. Örneğin:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - Chat API yöntemi, yönetici onayı gerektirmeyen
https://www.googleapis.com/auth/chat.botyetkilendirme kapsamını destekliyorsa bunun yerine bu kapsamı kullanabilirsiniz. Bir yöntemin hangi yetkilendirme kapsamlarını desteklediğini kontrol etmek için Google Chat uygulamaları ve Google Chat API isteklerinin kimliğini doğrulama ve yetkilendirme başlıklı makaleyi inceleyin.
Cloud Functions 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 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 Function'ını bulup İşlemleri göster > Günlükleri görüntüle'yi tıklayın.
Günlük Gezgini açılır ve hatalar da dahil olmak üzere Cloud Functions günlüklerini gösteren bir sorgu çalıştırır.
Varsayılan olarak kaydedilen bilgiler uygulamanızda hata ayıklamak için yeterli değilse Cloud Functions kodunuzdan ek günlük kaydı ekleyebilirsiniz. Cloud Functions günlüklerini görüntüleme ve yazma başlıklı makaleyi inceleyin.
Cloud Functions hatalarını kontrol etme
Cloud Functions, günlüklerin yanı sıra çalışırken karşılaşılan hataları da bildirebilir.
Google Cloud Console'da Cloud Functions sayfasına gidin:
Chat uygulamanızın Cloud Functions işlevini tıklayın.
İşlev ayrıntıları sayfasında hatalar Hatalar bölümünde listelenir.
Bir hatayla ilgili daha fazla sorun giderme işlemi yapmak için hatayı tıklayın.
Sık karşılaşılan Cloud Functions hatalarını düzeltme
Cloud Functions ile bir sohbet uygulaması oluştururken 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ını alabilirsiniz. Bu mesaj, dağıtmakta olduğunuz Cloud Function ile aynı ada sahip başka bir Cloud Function olduğunu gösterir. Adı değiştirin ve işlevi tekrar dağıtın. Sohbet uygulamasının, önceden var olan Cloud Functions işlevinin tetikleyici URL'si yerine Cloud Functions işlevinizin tetikleyici URL'sini kullandığını doğrulayın.
Politikada adı geçen kullanıcılardan biri veya daha fazlası izin verilen bir müşteriye ait değil
Bir Cloud Function'ı 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ını alabilirsiniz. Bu hatayı aldıktan sonra Chat uygulamasına mesaj gönderirseniz Google Chat, Cloud Function'ı barındıran sunucuya ulaşamadığı için uygulamanın yanıt vermediğini belirten bir hata mesajı alırsınız. Bu mesaj, "allUsers" adlı bir kullanıcının Cloud Functions işlevini çağırma izni olmadığını gösterir.
"allUsers"a "Cloud Functions Çağırıcısı" rolünü vermek, uygulamaya güç veren Cloud Function'ın herkese açık olduğu ve kimlik doğrulama olmadan erişilebileceği anlamına gelir. Rol atama hakkında bilgi edinmek için Tek bir rol verme başlıklı makaleyi inceleyin.
Bu hata, Google Cloud projesinin alanla kısıtlanmış olduğu anlamına gelebilir. Alan kısıtlama sınırlamaları hakkında daha fazla bilgi için Kimlikleri alana göre kısıtlama başlıklı makaleyi inceleyin.
Bu sorunu çözmek için Cloud Functions işlevinizin kimliği doğrulanmamış çağırmalara izin verdiğini doğrulayın. Mevcut bir Cloud Functions işlevi için kimliği doğrulanmamış çağırmalara nasıl izin vereceğinizi öğrenmek için Herkese açık (kimliği doğrulanmamış) erişime izin verme başlıklı makaleyi inceleyin.