Bu bölümde, Chat uygulamaları oluşturup 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 ya da ç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 > Yönet > Yapılandırma'yı tıklayın.
Uygulama durumu bölümünde Yayında - 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 1:1 mesaj alma'yı seçtiğinizden emin olun.
- Bağlantı ayarları bölümünde HTTP uç nokta 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 Google Workspace alanındaki e-posta adresiyle veya bir grupla uygulamaya erişebildiğinden emin olun. Uygulama Google Workspace Marketplace SDK'sı 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'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ı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ığı anlamına gelir. Chat uygulaması oluşturmak veya Chat API'yi kullanmak için Google Workspace hesabı kullanmanız 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şfettiği ve 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ın Chat geçmişini etkinleştirmesine veya devre dışı bırakmasına izin vermezse, sohbet geçmişini etkinleştirmeyi veya devre dışı bırakmayı zorunlu kılan kullanıcı düzeyindeki ayar ile kuruluş düzeyindeki zorunlu ayarı devralan alan arasındaki bir çakışma nedeniyle kullanıcıların bir alana katılamadığı veya alanda kalamadığı durumlarla karşılaşabilirsiniz.
Örneğin, bir kullanıcının sohbet geçmişi ayarı "açık" olarak zorunlu kılınmışsa ve bir alanın sohbet geçmişi ayarı "kapalı" olarak zorunlu kılınmışsa söz konusu 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ışma olan diğer senaryolarda Chat API üyelik oluşturamayabilir veya kullanıcı kimlik doğrulaması içeren bir mesaj oluşturmak, kimliği doğrulanmış ve çakışma yaşayan Chat geçmişi ayarına sahip 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ı'nda Gelişmiş Chat hizmetiyle ilgili sorunları giderme
Gelişmiş Sohbet Hizmeti hakkındaki Apps Komut Dosyası sayfasını inceleyin.
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 hata aşağıdakilerden biri nedeniyle oluşabilir:
- Kuruluş, Chat uygulamalarını devre dışı bırakmış olabilir.
- Kuruluş, söz konusu Chat uygulamasını izin verilenler listesine eklemedi.
Bir kullanıcı Chat uygulamasıyla etkileşim kurmaya çalışırken bu hata mesajıyla karşılaşırsa bunun nedeni, kuruluşun üst kuruluş birimi için etkinleştirmeden alt kuruluş birimine erişim izni vermesi olabilir.
Bu sorunun nasıl çözüleceği hakkında bilgi edinmek için Kullanıcıların Chat uygulamalarını yüklemesine izin verme başlıklı makaleyi inceleyin.
Yöneticinin, uygulamaya bu işlem için gerekli OAuth yetkilendirme kapsamını vermesi gerekir.
Chat uygulaması olarak kimlik doğrulama 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 Chat uygulamasına https://www.googleapis.com/auth/chat.app.* ile başlayan bir adla başlayan yetkilendirme kapsamlarını kullanması için henüz tek seferlik onay vermediği anlamına gelir.
Hatayı çözmek için:
- Google Workspace yöneticisinden Chat uygulamanıza onay vermesini isteyin. Chat uygulaması mantığınızda bu hatayı ele alırken, Chat uygulamasının istenen işlemi gerçekleştirmek için yönetici onayına ihtiyacı olduğunu belirten bir mesaj gönderebilirsiniz. Ö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 yöntemi 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 işlevi hatalarını giderme
Chat uygulaması Cloud Functions ile uygulanmışsa ve çalışmıyorsa aşağıdaki bölümlerde sorunu gidermenize ve düzeltmenize yardımcı olacak bilgiler verilmektedir.
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 Bulut İşlevi'ni 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 Function günlüklerini gösteren bir sorgu çalıştırır.
Günlüğe kaydedilen varsayılan bilgiler uygulamanızda hata ayıklama 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 işlevi, 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.
Hatalar, işlev ayrıntıları sayfasındaki 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 Chat uygulaması oluştururken bazen aşağıdaki hatalarla karşılaşılır.
PROJECT_NAME projesinin REGION_NAME bölgesinde 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, dağıttığınız Cloud Function'in başka bir Cloud Function ile aynı ada sahip olduğu anlamına gelir. Adı değiştirin ve işlevi tekrar dağıtın. Chat uygulamasında, mevcut Cloud Functions işlevinin tetikleyici URL'sini değil, Cloud Functions işleviniz için tetikleyici URL'yi kullandığını doğrulayın.
Politikada adı geçen bir veya daha fazla kullanıcı, izin verilen bir müşteriye ait değil
Bir Cloud işlevini 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 işlevini barındıran sunucuya ulaşamadığı için uygulamanın yanıt vermediğini belirten bir hata alırsınız. Bu mesaj, "allUsers" adlı bir kullanıcının Cloud Functions'ı çağırma iznine sahip olmadığı anlamına gelir.
"allUsers"a "Cloud Functions Çağırıcısı" rolünün verilmesi, uygulamayı destekleyen Cloud Functions işlevinin herkese açık olduğu ve kimlik doğrulama olmadan erişilebilir olduğu anlamına gelir. Nasıl rol atayacağınızı öğrenmek için Tek bir rol atama bölümünü inceleyin.
Bu hata, Google Cloud projesinin alanla sınırlı 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 başlıklı makaleyi inceleyin.
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 kimlik doğrulaması yapılmayan çağrılara nasıl izin vereceğinizi öğrenmek istiyorsanız Herkese açık (kimlik doğrulaması yapılmamış) erişime izin verme başlıklı makaleyi inceleyin.