Bu eğiticide, Google Chat kullanıcılarının kişisel ve işle ilgili kişilerini yönetmelerine yardımcı olan bir Google Chat uygulamasının nasıl oluşturulacağı gösterilmektedir. Chat uygulaması, bilgi toplamak için kullanıcılardan kart mesajlarında ve iletişim kutularında bir iletişim formu doldurmalarını ister.
Chat uygulamasının nasıl çalıştığını görün:
-
1. şekil. Chat uygulaması, eğik çizgiyle başlayan komuta /about
bir kısa mesaj ve iletişim formu açan bir düğmeyle yanıt verir. -
Şekil 2. Chat uygulamasında, kullanıcıların bir kişi hakkında bilgi girebileceği bir iletişim kutusu açılır. -
3. Şekil. Kullanıcıların bilgileri göndermeden önce inceleyip onaylayabilmesi için Chat uygulaması bir onay iletişim kutusu döndürür. -
4. Şekil. Kullanıcı formu gönderdikten sonra Chat uygulaması, gönderimi onaylamak için özel bir kısa mesaj gönderir. -
5. şekil. Chat uygulaması, kullanıcılardan mesajlardaki kartlardan kişi eklemelerini de ister.
Ön koşullar
- Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı.
Hedefler
- Kullanıcı arayüzlerini (UI) tasarlayıp oluşturun
ve kullanıcı arayüzlerini
card
nesneleri olarak mesajlarda ve iletişim kutularında gösterin. - Kullanıcıların form girişi widget'larını kullanarak gönderdiği bilgileri alma ve işleme
- Metin, kart ve aksesuar widget'ları içeren mesajlarla komutlara yanıt verme
Mimari
Chat uygulaması Google Apps Komut Dosyası ile oluşturulmuştur ve Chat kullanıcılarını işlemek ve yanıtlamak için etkileşim etkinliklerini kullanır.
Aşağıda, bir kullanıcının Chat uygulamasıyla nasıl etkileşim kurabileceği gösterilmektedir:
Kullanıcı, Chat uygulamasıyla doğrudan mesaj açar veya Chat uygulamasını mevcut bir alana ekler.
Chat uygulaması, kullanıcıya
card
nesnesi olarak bir iletişim formu oluşturup görüntüleyerek kişi eklemesini ister. İletişim formunu sunmak için Chat uygulaması, kullanıcılara aşağıdaki şekillerde yanıt verir:- @bahisler ve doğrudan mesajlara, iletişim formunu içeren bir kart mesajıyla yanıt verir.
/addContact
eğik çizgi komutuna yanıt olarak iletişim formu içeren bir iletişim kutusu açar.- Kullanıcıların iletişim formu içeren bir iletişim kutusu açmak için tıklayabileceği Kişi ekle düğmesi olan bir kısa mesajla
/about
eğik çizgi komutuna yanıt verir.
Kullanıcı, iletişim formu gösterildiğinde aşağıdaki alanlara ve widget'lara iletişim bilgilerini girer:
- Ad ve soyadı: Dizeleri kabul eden bir
textInput
widget'ı. - Doğum tarihi: Yalnızca tarihleri kabul eden bir
dateTimePicker
widget'ı. - Kişi türü: Kullanıcıların tek bir dize değeri (
Personal
veyaWork
) seçip göndermesine olanak tanıyan bir radyo düğmesi widget'ı.selectionInput
- İncele ve gönder düğmesi: Kullanıcının girdiği değerleri göndermek için tıkladığı
button
widget'ını içeren bir dizi.buttonList
- Ad ve soyadı: Dizeleri kabul eden bir
Google Chat uygulaması, kullanıcının girdiği değerleri işlemek için bir
CARD_CLICKED
etkileşim etkinliğini işler ve değerleri bir onay kartında gösterir.Kullanıcı, onay kartını inceleyip iletişim bilgilerini tamamlamak için Gönder düğmesini tıklar.
Google Chat uygulaması, gönderimi onaylayan özel bir kısa mesaj gönderir.
Ortamı hazırlama
Bu bölümde, Chat uygulaması için Google Cloud projesinin nasıl oluşturulacağı ve yapılandırılacağı gösterilmektedir.
Google Cloud projesi oluşturma
Google Cloud konsolu
- Google Cloud Console'da Menü > IAM & Admin > Proje Oluştur'a gidin.
-
Proje Adı alanına projeniz için açıklayıcı bir ad girin.
İsteğe bağlı: Proje kimliğini düzenlemek için Düzenle'yi tıklayın. Proje kimliği, proje oluşturulduktan sonra değiştirilemez. Bu nedenle, projenin kullanım ömrü boyunca ihtiyaçlarınızı karşılayacak bir kimlik seçin.
- Konum alanında, projeniz için olası konumları görüntülemek üzere Göz at'ı tıklayın. Ardından Seç'i tıklayın.
- Oluştur'u tıklayın. Google Cloud Console, Kontrol Paneli sayfasına gider ve projeniz birkaç dakika içinde oluşturulur.
gcloud CLI
Aşağıdaki geliştirme ortamlarından birinde Google Cloud KSA'ya (gcloud
) erişin:
-
Cloud Shell: gcloud KSA'nın önceden ayarlandığı bir online terminal kullanmak için Cloud Shell'i etkinleştirin.
Cloud Shell'i etkinleştirin. -
Yerel kabuk: Yerel geliştirme ortamı kullanmak için gcloud CLI'yı yükleyin ve başlatın.
Cloud projesi oluşturmak içingcloud projects create
komutunu kullanın: Oluşturmak istediğiniz projenin kimliğini ayarlayarak PROJECT_ID kısmını değiştirin.gcloud projects create PROJECT_ID
Kimlik doğrulama ve yetkilendirme ayarlarını yapma
Google Chat uygulamaları, kullanıcıların Google Chat dahil olmak üzere Google Workspace uygulamalarında uygulamanıza yetki verebilmesi için OAuth kullanıcı rızası ekranı yapılandırmanızı gerektirir.
Bu eğiticide yalnızca test ve dahili kullanım için bir Chat uygulaması dağıtacağınızdan izin ekranında yer tutucu bilgiler kullanabilirsiniz. Chat uygulamasını yayınlamadan önce yer tutucu bilgilerini gerçek bilgilerle değiştirin.
Google Cloud Console'da Menü > > Markalama'ya gidin.
yapılandırmasını daha önce yaptıysanız Markalama, Kitle ve Veri Erişimi'nde aşağıdaki OAuth izin ekranı ayarlarını yapılandırabilirsiniz. henüz yapılandırılmadı mesajını görürseniz Başlayın'ı tıklayın:
- App Information (Uygulama Bilgileri) bölümündeki App name (Uygulama adı) alanına
Contact Manager
yazın. - Kullanıcı destek e-postası bölümünde e-posta adresinizi veya uygun bir Google grubunu seçin.
- İleri'yi tıklayın.
- Kitle bölümünde Dahili'yi seçin. Dahili'yi seçemiyorsanız Harici'yi seçin.
- İleri'yi tıklayın.
- İletişim bilgileri bölümünde, projenizde yapılan değişikliklerle ilgili bildirim alabileceğiniz bir e-posta adresi girin.
- İleri'yi tıklayın.
- Bitir bölümünde Google API Hizmetleri Kullanıcı Verileri Politikası'nı inceleyin ve kabul ediyorsanız Google API Hizmetleri: Kullanıcı Verileri Politikası'nı kabul ediyorum'u seçin.
- Devam'ı tıklayın.
- Oluştur'u tıklayın.
- Kullanıcı türü için Harici'yi seçtiyseniz test kullanıcıları ekleyin:
- Kitle'yi tıklayın.
- Test kullanıcıları bölümünde Kullanıcı ekle'yi tıklayın.
- E-posta adresinizi ve yetkili diğer test kullanıcılarını girip Kaydet'i tıklayın.
- App Information (Uygulama Bilgileri) bölümündeki App name (Uygulama adı) alanına
Chat uygulamasını oluşturma ve dağıtma
Aşağıdaki bölümde, Chat uygulamanız için gerekli tüm uygulama kodunu içeren bir Apps Komut Dosyası projesinin tamamını kopyalayıp güncelleyeceksiniz. Bu nedenle, her dosyayı kopyalayıp yapıştırmanız gerekmez.
İsteğe bağlı olarak, projenin tamamını GitHub'da görüntüleyebilirsiniz.
Her dosyanın genel bir bakışını aşağıda bulabilirsiniz:
main.gs
Kullanıcıların Chat uygulamasına mesaj göndermesi, Chat uygulaması mesajındaki düğmeleri tıklaması veya iletişim kutularını açıp kapatmasıyla ilgili etkileşim etkinlikleri de dahil olmak üzere tüm uygulama mantığını işler.
main.gs
kodunu görüntülemecontactForm.gs
Kullanıcılardan form verilerini alan widget'ları içerir. Bu form girişi widget'ları, iletilerde ve iletişim kutularında görünen kartlarda gösterilir.
contactForm.gs
kodunu görüntülemeappsscript.json
Chat uygulaması için Apps Komut Dosyası projesini tanımlayan ve yapılandıran Apps Komut Dosyası manifesti.
appsscript.json
kodunu görüntüleme
Cloud proje numaranızı ve kimliğinizi bulma
Google Cloud Console'da Cloud projenize gidin.
Ayarlar ve Yardımcı Programlar > Proje ayarları'nı tıklayın.
Proje numarası ve Proje kimliği alanlarındaki değerleri not edin. Bunları aşağıdaki bölümlerde kullanabilirsiniz.
Apps Komut Dosyası projesini oluşturma
Apps Komut Dosyası projesi oluşturmak ve Cloud projenize bağlamak için:
- Google Chat'te kişileri yönetme Apps Komut Dosyası projesini açmak için aşağıdaki düğmeyi tıklayın.
Projeyi açın. - Genel bakış'ı tıklayın.
- Genel bakış sayfasında
Kopya oluştur'u tıklayın.
Apps Komut Dosyası projesinin kopyanıza ad verin:
Google Chat'te kişileri yönetme başlıklı makalenin kopyasını tıklayın.
Proje başlığı'na
Contact Manager - Google Chat app
yazın.Yeniden adlandır'ı tıklayın.
Apps Komut Dosyası projesinin Cloud projesini ayarlama
- Apps Komut Dosyası projenizde,
Proje Ayarları'nı tıklayın.
- Google Cloud Platform (GCP) Projesi bölümünde Projeyi değiştir'i tıklayın.
- GCP proje numarası bölümüne Cloud projenizin proje numarasını yapıştırın.
- Projeyi ayarla'yı tıklayın. Bulut projesi ve Apps Komut Dosyası projesi artık bağlı.
Apps Komut Dosyası dağıtımı oluşturma
Tüm kodlar yerleştirildiğine göre Apps Komut Dosyası projesini dağıtın. Google Cloud'da Chat uygulamasını yapılandırırken dağıtım kimliğini kullanırsınız.
Apps Komut Dosyası'nda Chat uygulamasının projesini açın.
Dağıt > Yeni dağıtım'ı tıklayın.
Eklenti henüz seçilmemişse Tür seçin'in yanındaki dağıtım türlerini
tıklayın ve Eklenti'yi seçin.
Açıklama bölümüne bu sürüm için bir açıklama girin (ör.
Test of Contact Manager
).Dağıt'ı tıklayın. Apps Komut Dosyası, dağıtımın başarılı olduğunu bildirir ve bir dağıtım kimliği sağlar.
Dağıtım kimliğini kopyalamak için
Kopyala'yı, ardından Bitti'yi tıklayın.
Google Cloud Console'da Chat uygulamasını yapılandırma
Bu bölümde, Google Cloud Console'da Google Chat API'nin nasıl yapılandırılacağı gösterilmektedir. Bu yapılandırma, Apps Komut Dosyası projenizden yeni oluşturduğunuz dağıtımın kimliği de dahil olmak üzere Chat uygulamanızla ilgili bilgileri içerir.
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 adı alanına
Contact Manager
yazın.Avatar URL'si bölümüne
https://developers.google.com/chat/images/contact-icon.png
yazın.Açıklama bölümüne
Manage your personal and business contacts
yazın.Etkileşimli özellikleri etkinleştir açma/kapatma düğmesini açık konumuna getirin.
İşlevsellik bölümünde Alanlara ve grup görüşmelerine katılma'yı seçin.
Bağlantı ayarları bölümünde Apps Komut Dosyası'nı seçin.
Dağıtım kimliği bölümüne, Apps Komut Dosyası dağıtımını oluştururken önceki bölümde kopyaladığınız Apps Komut Dosyası dağıtım kimliğini yapıştırın.
Komutlar bölümünde,
/about
ve/addContact
eğik çizgi komutlarını ayarlayın:- İlk eğik çizgi komutunu ayarlamak için Eğik çizgi komutu ekle'yi tıklayın.
- Ad alanına
About
yazın. - Command ID (Komut kimliği) alanına
1
yazın. - Açıklama bölümüne
Learn how to use this Chat app to manage your contacts
yazın. - Komut türü bölümünde
Slash command
simgesini seçin. - Eğik çizgi komutu adı bölümüne
/about
yazın. - İletişim kutusu açar'ı seçin.
- Bitti'yi tıklayın.
- Başka bir eğik çizgi komutu ayarlamak için Komut ekle'yi tıklayın.
- Ad alanına
Add a contact
yazın. - Command ID (Komut kimliği) alanına
2
yazın. - Açıklama bölümüne
Submit information about a contact
yazın. - Komut türü bölümünde
Slash command
simgesini seçin. - Eğik çizgi komutu adı bölümüne
/addContact
yazın. - İletişim kutusu açar'ı seçin.
- Bitti'yi tıklayın.
Görünürlük bölümünde, Bu sohbet uygulamasını YOUR DOMAIN'daki belirli kişi ve grupların kullanımına sun onay kutusunu işaretleyin ve e-posta adresinizi girin.
Günlükler bölümünde Günlük hatalarını Logging'e seçeneğini belirleyin.
Kaydet'i tıklayın. Yapılandırma kaydedildi mesajı gösterilir.
Chat uygulaması, Chat'te yüklenmeye ve test edilmeye hazırdır.
Chat uygulamasını 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.
Chat uygulamasıyla yeni doğrudan mesajda
/addContact
yazıp Enter tuşuna basın.Açılan iletişim kutusuna iletişim bilgilerini girin:
- Ad ve soyadı metin alanına bir ad girin.
- Doğum tarihi tarih seçicisinde bir tarih belirleyin.
- Kişi türü bölümünde İş veya Kişisel radyo düğmesini seçin.
İncele ve gönder'i tıklayın.
Onay iletişim kutusunda, gönderdiğiniz bilgileri inceleyin ve Gönder'i tıklayın. Chat uygulaması,
✅ CONTACT NAME has been added to your contacts.
yazan bir kısa mesajla yanıt verir.İsterseniz iletişim formunu aşağıdaki yöntemlerle de test edip gönderebilirsiniz:
/about
eğik çizgi komutunu kullanın. Sohbet uygulaması,Add a contact
yazan bir metin mesajı ve aksesuar widget'ı düğmesiyle yanıt veriyor. İletişim formu içeren bir iletişim kutusu açmak için düğmeyi tıklayabilirsiniz.- Chat uygulamasına eğik çizgi komutu olmadan doğrudan mesaj gönderme (ör.
Hello
). Chat uygulaması, iletişim formunu içeren bir metin ve kartla yanıt verir.
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
- Komutlara yanıt verme
- Google Chat kullanıcılarından bilgi toplama ve bu bilgileri işleme
- Etkileşimli iletişim kutularını açma
- Diğer Google Chat uygulama örneklerini inceleyin