Bu sayfada, HTTP Chat uygulamasının nasıl oluşturulacağı 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ıç kılavuzunda, 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 mimari sayesinde Chat'i, HTTP kullanarak aşağıdaki şemada gösterildiği gibi Google Cloud veya şirket içi bir sunucu ile entegre olacak şekilde yapılandırırsınız:
Önceki şemada, HTTP Chat uygulamasıyla etkileşimde bulunan bir kullanıcı aşağıdaki bilgi akışına sahiptir:
- Kullanıcı, Chat'teki bir Chat uygulamasına doğrudan mesaj veya bir Chat alanında mesaj gönderir.
- Chat uygulaması mantığını içeren bulut veya şirket içi sistem olan bir web sunucusuna HTTP isteği gönderilir.
- İsteğe bağlı olarak, Chat uygulama mantığı Google Workspace hizmetleri (Takvim ve E-Tablolar gibi), diğer Google hizmetleri (Haritalar, YouTube ve Vertex AI gibi) veya diğer web hizmetleriyle (ör. proje yönetim sistemi veya bilet işlemleri aracı) entegre edilebilir.
- Web sunucusu, Chat'teki Chat uygulaması hizmetine bir HTTP yanıtı gönderir.
- Yanıt kullanıcıya iletilir.
- İsteğe bağlı olarak, Chat uygulaması eşzamansız olarak mesaj yayınlamak veya başka işlemler gerçekleştirmek için Chat API'yi çağırabilir.
Chat uygulamaları farklı programlama dilleri kullanılarak tasarlanabileceği için bu mimari, sisteminizde zaten bulunan mevcut kitaplıkları ve bileşenleri kullanma esnekliği sağlar.
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 ve Google Cloud Functions'a erişimi olan bir Google Workspace hesabı.
- Bir Google Cloud projesi.
- Cloud projeniz için faturalandırmayı etkinleştirdiğinizden emin olun. Projelerinizin faturalandırma durumunu nasıl doğrulayacağınızı öğrenin.
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 konsolunda 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ı ve avatar resmiyle Chat kartı oluşturan bir 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.
İşlevi Chat uygulamanızda oluşturup dağıtmak için aşağıdaki adımları tamamlayın:
Node.js
Google Cloud Console'da Cloud Functions sayfasına gidin:
Chat uygulamanız için projenin seçili olduğundan emin olun.
İşlev Oluştur'u tıklayın.
İşlev oluştur sayfasında işlevinizi ayarlayın:
- Ortam bölümünde 2. nesil'i seçin.
- İşlev adı alanına
QuickStartChatApp
yazın. - Bölge'den bir bölge seçin.
- Kimlik doğrulama bölümünde Kimlik doğrulaması iste'yi seçin.
- İleri'yi tıklayın.
Çalışma zamanı'nda, Node.js'nin en son sürümünü seçin.
Kaynak kodu bölümünde Satır içi düzenleyici'yi seçin.
Giriş noktası bölümünde varsayılan metni silin ve
helloChat
yazın.index.js
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 için projenin seçili olduğundan emin olun.
İşlev Oluştur'u tıklayın.
İşlev oluştur sayfasında işlevinizi ayarlayın:
- Ortam bölümünde 2. nesil'i seçin.
- İşlev adı alanına
QuickStartChatApp
yazın. - Bölge'den bir bölge seçin.
- Kimlik doğrulama bölümünde Kimlik doğrulaması iste'yi seçin.
- İleri'yi tıklayın.
Çalışma zamanı'nda, Python'un en son sürümünü seçin.
Kaynak kodu bölümünde Satır içi düzenleyici'yi seçin.
Giriş noktası bölümünde varsayılan metni silin ve
hello_chat
yazın.main.py
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 için projenin seçili olduğundan emin olun.
İşlev Oluştur'u tıklayın.
İşlev oluştur sayfasında işlevinizi ayarlayın:
- Ortam bölümünde 2. nesil'i seçin.
- İşlev adı alanına
QuickStartChatApp
yazın. - Bölge'den bir bölge seçin.
- Kimlik doğrulama bölümünde Kimlik doğrulaması iste'yi seçin.
- İleri'yi tıklayın.
Çalışma zamanı'nda, Java'nın en son sürümünü seçin.
Kaynak kodu bölümünde Satır içi düzenleyici'yi seçin.
Giriş noktası bölümünde varsayılan metni silin ve
HelloChat
yazın.src/main/java/com/example/Example.java
öğesinin adınısrc/main/java/HelloChat.java
olarak değiştirin.HelloChat.java
içeriğini aşağıdaki kodla değiştirin:pom.xml
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şlevinizde biri derleme, diğeri hizmet için olmak üzere iki ilerleme göstergesi gösterilir. Her iki ilerleme göstergesi de kaybolduğunda ve yerine bir onay işareti konulduğunda işleviniz dağıtılır ve hazır olur.
Google Chat'e işlevinizi çağırma yetkisi verme
Google Chat'e işlevinizi çağırma yetkisi vermek için Cloud Run Çağırıcısı rolüne sahip Google Chat hizmet hesabını ekleyin.
Google Cloud Console'da Cloud Run sayfasına gidin:
Cloud Run hizmetleri listesinde alıcı işlevinin yanındaki onay kutusunu seçin. (İşlevi tıklamayın.)
İzinler'i tıklayın. İzinler paneli açılır.
Ana hesap ekle'yi tıklayın.
New principals (Yeni ana hesaplar) alanına
chat@system.gserviceaccount.com
yazın.Rol seçin bölümünde Cloud Run > Cloud Run Çağırıcısı'nı seçin.
Kaydet'i tıklayın.
Uygulamayı Google Chat'te yayınlama
Cloud Functions işlevi dağıtıldıktan sonra Google Chat uygulamasına dönüştürmek için aşağıdaki adımları uygulayın:
Google Cloud konsolunda Menü > Cloud Functions'ı tıklayın.
Cloud Functions'ı etkinleştirdiğiniz projenin seçildiğinden emin olun.
İşlevler listesinde QuickStartChatApp'i tıklayın.
Tetikleyiciler sekmesini tıklayın.
HTTPS'nin altındaki URL'yi kopyalayın.
"Google Chat API" ifadesini aratıp 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'sine
https://developers.google.com/chat/images/quickstart-app-avatar.png
yazın. - Açıklama alanına
Quickstart app
yazın. - İşlevler bölümünde, Bire bir mesaj al ve Alanlara ve grup görüşmelerine katıl'ı seçin.
- Bağlantı ayarları bölümünde Uygulama URL'si'ni seçin ve Cloud Functions işlevi tetikleyicisinin URL'sini kutuya yapıştırın.
- Kimlik Doğrulama Kitlesi bölümünde Uygulama URL'si'ni seçin.
- Görünürlük bölümünde, Bu Google Chat uygulamasını alanınızdaki belirli kişiler ve gruplar için kullanılabilir yap'ı seçin ve e-posta adresinizi girin.
- Günlükler bölümünde, Hataları günlüğe kaydetme'yi seçin.
- Uygulama adı alanına
Kaydet'i tıklayın.
Chat uygulaması, Chat'te mesaj almaya ve mesajları yanıtlamaya hazırdır.
Chat uygulamanızı test etme
Chat uygulamanızı test etmek için Chat uygulamasıyla bir doğrudan mesaj alanı açın ve mesaj gönderin:
Kendinizi Güvenilir Test Kullanıcısı olarak 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çlar arasından Chat uygulamanızı seçin. Bir doğrudan mesaj açılır.
- Uygulamayı içeren yeni doğrudan mesajda
Hello
yazıpenter
tuşuna basın.
Chat uygulamasının yanıtı, aşağıdaki resimde gösterildiği gibi, gönderenin adını ve avatar resmini gösteren bir kart mesajı içerir:
Güvenilir test kullanıcıları eklemek 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
Google Chat uygulaması veya kartı hata döndürdüğünde Chat arayüzünde "Bir sorun oluştu" mesajı gösterilir. veya "İsteğiniz işlenemiyor." Bazı durumlarda Chat kullanıcı arayüzünde herhangi bir hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç verir. Örneğin, kart mesajı görünmeyebilir.
Chat kullanıcı arayüzünde hata mesajı görüntülenmese de Chat uygulamaları için hata günlük kaydı etkinleştirildiğinde hataları düzeltmenize yardımcı olmak amacıyla açıklayıcı hata mesajları ve günlük verileri sunulur. Hataları görüntüleme, hata ayıklama ve düzeltme konusunda yardım almak için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.
Temizleme
Bu eğiticide kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini istemiyorsanız Cloud projesini silmenizi öneririz.
- Google Cloud konsolunda Kaynakları yönetin sayfasına gidin. Menü > IAM ve Yönetici > Kaynakları Yönet'i tıklayın.
- Proje listesinde, silmek istediğiniz projeyi seçin ve ardından Sil simgesini tıklayın.
- İletişim kutusuna proje kimliğini yazın ve projeyi silmek için Kapat'ı tıklayın.
İlgili konular
Chat uygulamanıza daha fazla özellik eklemek için aşağıdakilere göz atın: