Bu sayfada, HTTP Chat uygulaması oluşturma açıklanmaktadır. Bu mimariyi uygulamanın farklı yolları vardır. Google Cloud'da Cloud Functions, Cloud Run ve App Engine'i kullanabilirsiniz. Bu hızlı başlangıçta, Chat uygulamasının kullanıcının mesajına yanıt vermek için kullandığı bir Cloud Functions işlevi yazıp dağıtacaksınız.
Bu mimariyle, aşağıdaki şemada gösterildiği gibi HTTP kullanarak Chat'i Google Cloud veya şirket içi bir sunucuyla entegre olacak şekilde yapılandırabilirsiniz:
Yukarıdaki şemada, bir HTTP Chat uygulamasıyla etkileşimde bulunan kullanıcının bilgi akışı şu şekildedir:
- Bir kullanıcı, Chat'te doğrudan mesaj veya Chat alanı üzerinden bir Chat uygulamasına mesaj gönderir.
- Chat uygulaması mantığını içeren bir bulut veya şirket içi sistem olan bir web sunucusuna HTTP isteği gönderilir.
- İsteğe bağlı olarak, Chat uygulaması mantığı Google Workspace hizmetleri (ör. Takvim ve E-Tablolar), diğer Google hizmetleri (ör. Haritalar, YouTube ve Vertex AI) veya diğer web hizmetleriyle (ör. proje yönetim sistemi ya da destek kaydı aracı) entegre edilebilir.
- Web sunucusu, Chat'teki Chat uygulaması hizmetine bir HTTP yanıtı geri gönderir.
- Yanıt, kullanıcıya iletilir.
- İsteğe bağlı olarak, Chat uygulaması mesajları eşzamansız olarak yayınlamak veya başka işlemler gerçekleştirmek için Chat API'yi çağırabilir.
Bu mimari, farklı programlama dilleri kullanılarak tasarlanabilen bu sohbet uygulamaları sayesinde sisteminizde zaten bulunan mevcut kitaplıkları ve bileşenleri kullanma esnekliği sunar.
Hedefler
- Ortamınızı ayarlayın.
- Cloud Functions işlevi oluşturma ve dağıtma
- Uygulamayı Chat'te yayınlayın.
- Uygulamayı test edin.
Ön koşullar
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı.
- Faturalandırmanın etkin olduğu bir Google Cloud projesi. Mevcut bir projede faturalandırmanın etkinleştirildiğini kontrol etmek için Projelerinizin faturalandırma durumunu doğrulama bölümüne bakın. Proje oluşturma ve faturalandırmayı ayarlama hakkında bilgi edinmek için Google Cloud projesi oluşturma başlıklı makaleyi inceleyin.
Ortamı ayarlama
Google API'lerini kullanmadan önce bir Google Cloud projesinde etkinleştirmeniz gerekir. Tek bir Google Cloud projesinde bir veya daha fazla API'yi etkinleştirebilirsiniz.Google Cloud Console'da Google Chat API, Cloud Build API, Cloud Functions API, Cloud Pub/Sub API, Cloud Logging API, Artifact Registry API ve Cloud Run API'yi etkinleştirin.
Cloud Functions işlevi oluşturma ve dağıtma
Gönderenin görünen adını ve avatar resmini içeren bir Chat kartı oluşturan Cloud Functions işlevi oluşturup dağıtın. Chat uygulaması bir mesaj aldığında işlevi çalıştırır ve kartla yanıt verir.
Chat uygulamanız için işlev oluşturup dağıtmak üzere aşağıdaki adımları tamamlayın:
Node.js
Google Cloud Console'da Cloud Functions sayfasına gidin:
Chat uygulamanızın projesinin seçildiğinden emin olun.
Create Function'ı (İşlev oluştur) tıklayın.
İşlev oluşturma sayfasında işlevinizi ayarlayın:
- Ortam'da Cloud Run işlevi'ni seçin.
- İşlev adı alanına
QuickStartChatApp
girin. - Bölge'de bir bölge seçin.
- Kimlik Doğrulama bölümünde Kimlik doğrulama gerektir'i seçin.
- İleri'yi tıklayın.
Çalışma zamanı bölümünde Node.js'nin en son sürümünü seçin.
Kaynak kodu bölümünde Satır İçi Düzenleyici'yi seçin.
Giriş noktası bölümünde varsayılan metni silip
avatarApp
değerini girin.index.js
dosyasının içeriğini aşağıdaki kodla değiştirin:Dağıt'ı tıklayın.
Python
Google Cloud Console'da Cloud Functions sayfasına gidin:
Chat uygulamanızın projesinin seçildiğinden emin olun.
Create Function'ı (İşlev oluştur) tıklayın.
İşlev oluşturma sayfasında işlevinizi ayarlayın:
- Ortam'da Cloud Run işlevi'ni seçin.
- İşlev adı alanına
QuickStartChatApp
girin. - Bölge'de bir bölge seçin.
- Kimlik Doğrulama bölümünde Kimlik doğrulama gerektir'i seçin.
- İleri'yi tıklayın.
Çalışma zamanı bölümünde en son Python sürümünü seçin.
Kaynak kodu bölümünde Satır İçi Düzenleyici'yi seçin.
Giriş noktası bölümünde varsayılan metni silip
avatar_app
değerini girin.main.py
dosyasının içeriğini aşağıdaki kodla değiştirin:Dağıt'ı tıklayın.
Java
Google Cloud Console'da Cloud Functions sayfasına gidin:
Chat uygulamanızın projesinin seçildiğinden emin olun.
Create Function'ı (İşlev oluştur) tıklayın.
İşlev oluşturma sayfasında işlevinizi ayarlayın:
- Ortam'da Cloud Run işlevi'ni seçin.
- İşlev adı alanına
QuickStartChatApp
girin. - Bölge'de bir bölge seçin.
- Kimlik Doğrulama bölümünde Kimlik doğrulama gerektir'i seçin.
- İleri'yi tıklayın.
Çalışma zamanı bölümünde Java'nın en son sürümünü seçin.
Kaynak kodu bölümünde Satır İçi Düzenleyici'yi seçin.
Giriş noktası bölümünde varsayılan metni silip
App
değerini girin.src/main/java/com/example/Example.java
öğesinisrc/main/java/AvatarApp.java
olarak yeniden adlandırın.AvatarApp.java
dosyasının içeriğini aşağıdaki kodla değiştirin:pom.xml
dosyasının içeriğini aşağıdaki kodla değiştirin:Dağıt'ı tıklayın.
Cloud Functions ayrıntılar sayfası açılır ve işleviniz iki ilerleme göstergesiyle birlikte görünür: biri derleme, diğeri ise hizmet için. Her iki ilerleme göstergesi de kaybolup yerini onay işaretine bıraktığında işleviniz dağıtılmış ve hazır demektir.
Google Chat'in işlevinizi çağırmasına izin verme
Google Chat'in işlevinizi çağırmasına izin vermek için Google Chat hizmet hesabını Cloud Run Invoker rolüyle ekleyin.
Google Cloud Console'da Cloud Run sayfasına gidin:
Cloud Run hizmetleri listesinde, alıcı işlevin yanındaki onay kutusunu işaretleyin. (İşlevin kendisini tıklamayın.)
İzinler'i tıklayın. İzinler paneli açılır.
Ana hesap ekle'yi tıklayın.
Yeni ana hesaplar bölümüne
chat@system.gserviceaccount.com
girin.Rol seçin bölümünde Cloud Run > Cloud Run Invoker'ı seçin.
Kaydet'i tıklayın.
Uygulamayı Google Chat'te yayınlama
Cloud Function dağıtıldıktan sonra, bunu Google Chat uygulamasına dönüştürmek için aşağıdaki adımları uygulayın:
Google Cloud Console'da Menü > Cloud Functions'ı tıklayın.
Cloud Functions'ı etkinleştirdiğiniz projenin seçili olduğundan emin olun.
İşlevler listesinde QuickStartChatApp'i tıklayın.
Tetikleyiciler sekmesini tıklayın.
HTTPS bölümünde URL'yi kopyalayın.
"Google Chat API"yi arayın ve Google Chat API'yi, ardından Yönet'i tıklayın.
Yapılandırma'yı tıklayın ve Google Chat uygulamasını ayarlayın:
- Uygulama adı alanına
Quickstart App
yazın. - Avatar URL'si bölümüne
https://developers.google.com/chat/images/quickstart-app-avatar.png
girin. - Açıklama bölümüne
Quickstart app
girin. - İşlevsellik bölümünde Alanlara ve grup görüşmelerine katılma'yı seçin.
- Bağlantı ayarları bölümünde HTTP uç noktası URL'si'ni seçin ve Cloud Function tetikleyicisinin URL'sini kutuya yapıştırın.
- Authentication Audience (Kimlik Doğrulama Kitlesi) bölümünde HTTP endpoint URL'yi (HTTP uç noktası URL'si) seçin.
- Görünürlük bölümünde, alanınızdaki Bu Google Chat uygulamasını belirli kişilerin ve grupların kullanımına sun'u seçip e-posta adresinizi girin.
- Günlükler bölümünde Günlük hatalarını Logging'e seçeneğini belirleyin.
- Uygulama adı alanına
Kaydet'i tıklayın.
Chat uygulaması, Chat'teki mesajları almaya ve yanıtlamaya hazırdır.
Chat uygulamanızı test etme
Chat uygulamanızı test etmek için Chat uygulamasıyla doğrudan mesajlaşma alanı açıp mesaj gönderin:
Kendinizi güvenilir test kullanıcıları arasına eklerken sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.
- Yeni sohbet'i tıklayın.
- 1 veya daha fazla kişi ekle alanına Chat uygulamanızın adını yazın.
Sonuçlardan Chat uygulamanızı seçin. Doğrudan mesaj açılır.
- Uygulamayla yeni doğrudan mesajda
Hello
yazıpenter
tuşuna basın.
Chat uygulamasının yanıtında, aşağıdaki resimde gösterildiği gibi gönderenin adını ve avatar resmini gösteren bir kart mesajı yer alır:
Güvenilir test kullanıcıları ekleme ve etkileşimli özellikleri test etme hakkında daha fazla bilgi edinmek için Google Chat uygulamaları için etkileşimli özellikleri test etme başlıklı makaleyi inceleyin.
Sorun giderme
Bir Google Chat uygulaması veya kartı hata döndürdüğünde Chat arayüzünde "Bir hata oluştu" mesajı gösterilir. veya "İsteğiniz işlenemiyor." Bazen Chat kullanıcı arayüzünde hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç üretir. Örneğin, kart mesajı görünmeyebilir.
Chat kullanıcı arayüzünde hata mesajı gösterilmese de Chat uygulamaları için hata günlüğü kaydı etkinleştirildiğinde hataları düzeltmenize yardımcı olacak açıklayıcı hata mesajları ve günlük verileri kullanılabilir. Hataları görüntüleme, hataları ayıklama ve düzeltme konusunda yardım için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.
Temizleme
Bu eğitimde kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini önlemek istiyorsanız Cloud projesini silmenizi öneririz.
- Google Cloud Console'da Kaynakları yönetin sayfasına gidin. Şunu tıklayın: Menü > IAM ve Yönetici > Kaynakları Yönetin.
- Proje listesinde, silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
- İletişim kutusunda proje kimliğini yazın ve ardından projeyi silmek için Kapat'ı tıklayın.
İlgili konular
Chat uygulamanıza daha fazla özellik eklemek için aşağıdaki makalelere göz atın: