Bu eğitimde, Google Chat kullanıcıları, özel ve iş kişilerini yönetir. Chat uygulaması, bilgi toplamak için kullanıcılardan kart mesajlarındaki ve iletişim kutularındaki iletişim formunu doldurmalarını ister.
Chat uygulamasını çalışırken görün:
-
.
Şekil 2. İlgili içeriği oluşturmak için kullanılan Chat uygulaması, kullanıcıların şu işlemleri yapabileceği bir iletişim kutusu açar: bir kişiyle ilgili giriş bilgilerini girin. -
.
Şekil 3. İlgili içeriği oluşturmak için kullanılan Chat uygulaması bir onay iletişim kutusu döndürüyor inceleyip onaylaması için kullanıcıların gönderin. -
Şekil 4. Kullanıcı isteği gönderdikten sonra Chat uygulaması, muhatabınıza özel bir kısa mesaj gönderebilirsiniz. -
.
Şekil 5. İlgili içeriği oluşturmak için kullanılan Chat uygulaması, kullanıcılardan kişi eklemelerini de ister. bir kart aracılığıyla görüntüleyebilirsiniz.
Ön koşullar
- İşletme veya Kuruluş Şuna erişimi olan Google Workspace hesabı: Google Chat.
Hedefler
card
nesneleri olarak kullanıcı arayüzleri (UI'ler) tasarlayıp oluşturun ve UI'leri mesajlarda ve iletişim kutularında gösterin.- Kullanıcıların form giriş widget'ları.
- Eğik çizgi komutlarına yanıt vermek için gönderin. Metin, kart ve aksesuar widget'ları içeren iletiler.
Mimari
Chat uygulaması yerleşik olarak mevcut Google Apps Komut Dosyası'na etkileşim etkinliklerinin işlenmesi sohbet edebiliyorlar.
Burada, bir kullanıcının Merchant Center'daki Chat uygulaması:
Kullanıcı Chat uygulamasında doğrudan mesaj açtığında veya Chat uygulamasını mevcut bir alana ekler.
Chat uygulaması, kullanıcıdan bir iletişim formu oluşturmak ve bu formu
card
nesnesini tanımlayın. Chat uygulaması, iletişim formunu sunmak için kullanıcılara aşağıdaki şekillerde yanıt verir:- @bahsetmelere ve doğrudan mesajlara şu kartla yanıt verir: iletişim formunu içerdiğinden emin olun.
/addContact
eğik çizgi komutuna şu başlığa sahip bir iletişim kutusu açarak yanıt verir: iletişim formunu doldurun./about
eğik çizgi komutuna, kullanıcıların iletişim formu içeren bir iletişim kutusu açmak için tıklayabilecekleri Kişi ekle düğmesinin bulunduğu bir metin mesajıyla yanıt verir.
İletişim formuyla birlikte sunulduğunda kullanıcı, iletişim bilgilerini girer. aşağıdaki alanlarda ve widget'larda:
- Ad ve soyadı:
textInput
widget'ını kullanabilirsiniz. - Doğum tarihi:
dateTimePicker
widget'ını kullanabilirsiniz. - Kişi türü:
selectionInput
kullanıcıların tek bir dize seçip göndermesine olanak tanıyan radyo düğmelerinin widget'ı değer (Personal
veyaWork
). - İncele ve gönder düğmesi: Kullanıcının girdiği değerleri göndermek için tıkladığı
button
widget'ı içeren birbuttonList
dizisi.
- Ad ve soyadı:
Google Chat uygulaması bir
CARD_CLICKED
etkileşim etkinliğini gerçekleştirir kullanıcı tarafından girilen değerleri işlemek ve onay kartına bakın.Kullanıcı onay kartını inceler ve Gönder düğmesini tıklar. iletişim bilgilerini son haline getirin.
Google Chat uygulaması, emin olun.
Ortamı hazırlama
Bu bölümde, web sitesi için Google Cloud projesinin nasıl Chat uygulaması.
Google Cloud projesi oluşturma
Google Cloud Console
- Google Cloud konsolunda Menü'ye gidin > IAM ve Yönetici > Proje oluşturun'u tıklayın.
-
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 değiştirilemez Bu nedenle, ilk deneme süresi boyunca ihtiyaçlarınızı karşılayan bir kimlik seçin. belirler.
- Konum alanında, işletmenizin olası konumlarını görüntülemek için Göz at'ı tıklayın belirler. Ardından Seç'i tıklayın.
- Oluştur'u tıklayın. Google Cloud Console, Kontrol Paneli sayfasına gider ve projeniz oluşturulur birkaç dakika.
gcloud CLI
Aşağıdaki geliştirme ortamlarından birinde Google Cloud
KSA (gcloud
):
-
Cloud Shell: gcloud CLI'nin önceden ayarlandığı bir internet terminali kullanmak için Cloud Shell'i etkinleştirin.
Cloud Shell'i etkinleştirme -
Yerel Kabuk: Yerel bir geliştirme ortamı kullanmak için gcloud CLI'yi yükleyin ve başlatın.
. Bir Cloud projesi oluşturmak içingcloud projects create
komutunu kullanın: Oluşturmak istediğiniz projenin kimliğini ayarlayarak PROJECT_ID değerini değiştirin.gcloud projects create PROJECT_ID
Kimlik doğrulama ve yetkilendirme ayarlarını yapma
Google Chat uygulamaları için OAuth izin ekranını kullanıcılar, aşağıdakiler de dahil olmak üzere Google Workspace uygulamalarında uygulamanızı yetkilendirebilir: Google Chat
Bu eğiticide yalnızca için yer tutucu bilgileri de kullanabilirsiniz. Bu nedenle, izin ekranını seçin. Chat uygulamasını yayınlamadan önce gerçek bilgileri içeren yer tutucu bilgileri içerir.
Google Cloud konsolunda şu adrese gidin: Menü > API'ler ve Hizmetler > OAuth izin ekranı'nı tıklayın.
Kullanıcı türü bölümünde Dahili'yi seçin ve ardından Oluştur'u tıklayın.
Uygulama adı alanına
Contact Manager
yazın.Kullanıcı desteği e-postası bölümünde e-posta adresinizi veya Google grubu.
Geliştirici iletişim bilgileri bölümünün altına e-posta adresinizi girin.
Kaydet ve Devam Et'i tıklayın.
Kapsamlar sayfasında Kaydet ve Devam Et'i tıklayın. (Chat uygulaması için OAuth kapsamı gerekmez.)
Özeti inceleyin ve ardından Kontrol Paneline Dön'ü tıklayın.
Chat uygulamasını oluşturma ve dağıtma
Aşağıdaki bölümde bir Gerekli tüm uygulamaları içeren Apps Komut Dosyası projesi olduğundan emin olmak için hem mevcut hem de her dosyayı yapıştırın.
İsterseniz projenin tamamını GitHub'da görüntüleyebilirsiniz.
Aşağıda, her bir dosyaya ilişkin genel bakış 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ı yönetir.
main.gs
kodunu göstercontactForm.gs
Kullanıcılardan form verileri alan widget'ları içerir. Bu form giriş widget'ları, mesajlarda ve iletişim kutularında görünen kartlarda gösterilir.
contactForm.gs
kodunu gösterappsscript.json
Chat uygulaması için Apps Komut Dosyası projesini tanımlayan ve yapılandıran Apps Komut Dosyası manifesti.
appsscript.json
kodunu göster
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. Siz kullanabilirsiniz.
Apps Komut Dosyası projesini oluşturma
Apps Komut Dosyası projesi oluşturmak ve bu projeyi Cloud projesi:
- 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çma - Genel Bakış'ı tıklayın.
- Genel bakış sayfasında Kopya oluştur'u tıklayın.
Apps Komut Dosyası projesinin kopyanıza bir ad verin:
Google Chat'te kişileri yönetmeyle ilgili 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 ayarlayın
- Apps Komut Dosyası projenizde Proje Ayarları'nı tıklayın.
- Google Cloud Platform (GCP) Project bölümünde Projeyi değiştir seçeneğini tıklayın.
- GCP proje numarası alanına Cloud projenizin proje numarasını yapıştırın.
- Proje ayarla'yı tıklayın. Cloud projesi ve Apps Komut Dosyası şimdi de bağlantılı.
Apps Komut Dosyası dağıtımı oluşturma
Tüm kod eklendiğinden Apps Komut Dosyası projesini dağıtın. Dağıtım kimliğini, Google Cloud'daki Chat uygulaması.
Apps Komut Dosyası'nda Chat uygulamasının belirler.
Dağıt'ı tıklayın > Yeni dağıtım.
Eklenti henüz seçilmemişse Türü seç'in yanındaki dağıtım türlerini tıklayın ve Eklenti'yi seçin.
Açıklama alanına bu sürüm için bir açıklama girin (ör.
Test of Contact Manager
).Dağıt'ı tıklayın. Apps Komut Dosyası raporları başarılı dağıtım kimliği sağlar ve bir dağıtım kimliği sağlar.
Dağıtım kimliğini kopyalamak için
Kopyala'yı ve 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, Apps Script projenizden yeni oluşturduğunuz dağıtımın kimliği de dahil olmak üzere Chat uygulamanızla ilgili bilgilerle nasıl yapılandırılacağı gösterilmektedir.
Google Cloud konsolunda Menü'yü tıklayın. > Diğer ürünler > Google Workspace > Ürün Kitaplığı > Google Chat API > Yönet > Yapılandırma.
Uygulama adı alanına
Contact Manager
yazın.Avatar URL'si alanına
https://developers.google.com/chat/images/contact-icon.png
yazın.Açıklama alanına
Manage your personal and business contacts
yazın.Etkileşimli özellikleri etkinleştir düğmesini tıklayarak açık konuma getirin.
İşlevsellik bölümünde, Bire bir mesajlar al onay kutularını işaretleyin ve Alanlara ve grup görüşmelerine katılabilirsiniz.
Bağlantı ayarları bölümünde Apps Komut Dosyası'nı seçin.
Deployment ID (Dağıtım Kimliği) alanına Apps Komut Dosyası Dağıtım Kimliğini yapıştırın. önceki bölümde kopyaladığınız, Apps Komut Dosyası dağıtımı.
Eğik çizgi komutları altında, eğik çizgi komutlarını
/about
ve/addContact
:- İlk eğik çizgi komutunu ayarlamak için Eğik çizgi komutu ekle'yi tıklayın.
- Ad alanına
/about
yazın. - Komut Kimliği'ne
1
yazın. - Açıklama alanına şunu yazın:
Learn how to use this Chat app to manage your contacts
. - Bir iletişim kutusu açar'ı seçin.
- Bitti'yi tıklayın.
- Başka bir eğik çizgi komutu oluşturmak için Eğik çizgi komutu ekle'yi tıklayın.
- Ad alanına
/addContact
yazın. - Komut Kimliği'ne
2
yazın. - Açıklama alanına şunu yazın:
Submit information about a contact
. - Bir iletişim kutusu açar'ı seçin.
- Bitti'yi tıklayın.
Görünürlük altında, Bu Chat uygulamasını YOUR DOMAIN kuruluşundaki belirli kişi ve grupların kullanımına sunun onay kutusunu işaretleyip e-posta adresinizi girin.
Günlükler bölümünde, Hataları günlüğe kaydetme'yi seçin.
Kaydet'i tıklayın. Yapılandırma tarafından kaydedilen bir mesaj gösterilir.
Chat uygulaması, Chat'te yüklenip test edilmeye hazırdır.
Chat uygulamasını test etme
Chat uygulamanızı test etmek için Chat uygulamasıyla bir doğrudan mesaj alanı açın ve mesaj gönderin:
Oluşturduğunuz Google Workspace hesabını kullanarak Google Chat'i açın ve kendinizi güvenilir test kullanıcısı olarak eklediğinizde sağlanan erişimdir.
- Yeni sohbet'i tıklayın.
- 1 veya daha fazla kişi ekle alanına eklemek istediğiniz kişinin adını Chat uygulaması.
Sonuçlar arasından Chat uygulamanızı seçin. Doğrudan mesajı açılır.
Chat uygulamasındaki 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 tarihi seçicisinde bir tarih seçin.
- 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 metin mesajıyla yanıt verir.İsterseniz iletişim formunu aşağıdaki yöntemlerle de test edip gönderebilirsiniz:
/about
eğik çizgi komutunu kullanın. Chat uygulaması yanıtları İçinde şöyle bir kısa mesaj ve bir aksesuar widget düğmesi görünüyor:Add a contact
İletişim formunu içeren iletişim kutusunu açmak için düğmeyi tıklayabilirsiniz.- Chat uygulamasına,
eğik çizgi komutu (ör.
Hello
). Chat uygulaması, iletişim formunu içeren bir metin ve kartla yanıt verir.
Temizleme
Bu eğiticide kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini istemiyorsanız Cloud projesini silmenizi öneririz.
-
Google Cloud Console'da Kaynakları yönetin sayfasına gidin. Menü > IAM ve Yönetici > Kaynakları Yönet'i tıklayın.
Resource Manager'a git 'nı inceleyin.
- Proje listesinde, silmek istediğiniz projeyi seçin ve ardından Sil'i tıklayın.
- İletişim kutusuna proje kimliğini yazın ve silmek için Kapat'ı tıklayın gösterir.
İlgili konular
- Eğik çizgi komutlarına yanıt verme
- Google Chat kullanıcılarından bilgi toplama ve işleme
- Etkileşimli iletişim kutuları açma
- Diğer Google Chat uygulaması örneklerini inceleyin