Google Apps Komut Dosyası ile Google Chat uygulaması oluşturma

Doğrudan mesaj gönderebileceğiniz ve mesajlarınızı tekrarlayarak yanıt veren bir Google Chat uygulaması oluşturun.

Aşağıdaki şemada mimari ve mesajlaşma modeli gösterilmektedir:

Yukarıdaki şemada, bir Apps Komut Dosyası Chat uygulamasıyla etkileşimde bulunan kullanıcının bilgi akışı şu şekildedir:

1. Kullanıcı, Chat uygulamasına doğrudan mesaj veya Chat alanı üzerinden mesaj gönderir.
2. Google Cloud'da bulunan Apps Komut Dosyası'nda uygulanan Chat uygulaması mantığı, mesajı alır ve işler.
3. İsteğe bağlı olarak, Chat uygulaması mantığı Google Workspace hizmetleriyle (ör. Takvim veya E-Tablolar) ya da diğer Google hizmetleriyle (ör. Google Haritalar veya YouTube) entegre edilebilir.
4. Chat uygulaması mantığı, Chat'teki Chat uygulaması hizmetine yanıt gönderir.
5. Yanıt, kullanıcıya iletilir.

Hedefler

• Ortamınızı ayarlayın.
• Komut dosyasını ayarlayın.
• Chat uygulamasını yayınlayın.
• Chat uygulamasını test edin.

Ön koşullar

• Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı.
• Google Cloud projesi. Google Cloud projesi oluşturmak için Google Cloud projesi oluşturma başlıklı makaleyi inceleyin.

Ortamınızı ayarlama

Cloud projenizi Google Cloud Console'da açın.

Henüz açık değilse bu örnek için kullanmayı planladığınız Cloud projesini açın:

1. Google Cloud Console'da Proje seçin sayfasına gidin.

   Bir bulut projesi seçin

2. Kullanmak istediğiniz Google Cloud projesini seçin. Alternatif olarak, Proje oluştur'u tıklayıp ekrandaki talimatları uygulayın. Google Cloud projesi oluşturursanız proje için faturalandırmayı etkinleştirmeniz gerekebilir.

Chat API'yi etkinleştirme

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'yi etkinleştirin.

  API'yi etkinleştirme

OAuth onay ekranını yapılandırma

OAuth 2.0 kullanan tüm uygulamalar için izin ekranı yapılandırması gerekir. Uygulamanızın OAuth izin ekranını yapılandırmak, kullanıcılara ve uygulama inceleyicilerine nelerin gösterileceğini tanımlar ve uygulamanızı kaydeder. Böylece, uygulamanızı daha sonra yayınlayabilirsiniz.

1. Google Cloud Console'da Menü menu > > Markalama'ya gidin.

   Markalama'ya gidin

2. özelliğini zaten yapılandırdı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:
1. Uygulama Bilgileri bölümündeki Uygulama adı alanına uygulamanın adını girin.
2. Kullanıcı destek e-postası bölümünde, kullanıcıların rızalarıyla ilgili soruları olduğunda sizinle iletişime geçebileceği bir destek e-posta adresi seçin.
3. İleri'yi tıklayın.
4. Kitle bölümünde Dahili'yi seçin.
5. İleri'yi tıklayın.
6. İletişim bilgileri bölümünde, projenizde yapılan değişikliklerle ilgili bildirim alabileceğiniz bir e-posta adresi girin.
7. İleri'yi tıklayın.
8. 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.
9. Devam'ı tıklayın.
10. Oluştur'u tıklayın.
3. Şimdilik kapsam eklemeyi atlayabilirsiniz. Gelecekte Google Workspace kuruluşunuzun dışında kullanılacak bir uygulama oluşturduğunuzda Kullanıcı türü'nü Harici olarak değiştirmeniz gerekir. Ardından, uygulamanızın gerektirdiği yetkilendirme kapsamlarını ekleyin. Daha fazla bilgi için OAuth iznini yapılandırma başlıklı kılavuzun tamamını inceleyin.

Komut dosyasını ayarlama

Komut dosyasını ayarlamak için bir şablon kullanır ve ardından Apps Komut Dosyası'nda Cloud projenizi ayarlarsınız.

Şablondan komut dosyası oluşturma

1. Apps Komut Dosyası Başlangıç sayfasına gidin.
2. Sayfanın üst kısmındaki Chat App şablonunu tıklayın.
3. Adsız proje'yi tıklayın, Quickstart app yazın ve Yeniden adlandır'ı tıklayın.

Cloud proje numarasını kopyalayın

1. Google Cloud Console'da Menü menu > IAM ve Yönetici > Ayarlar'a gidin.

   IAM ve Yönetici Ayarları'na gitme

2. Proje numarası alanındaki değeri kopyalayın.

Apps Komut Dosyası projesinin Cloud projesini ayarlama

1. Chat uygulaması Apps Komut Dosyası projesinde, Proje Ayarları'nı tıklayın.
2. Google Cloud Platform (GCP) Projesi bölümünde Projeyi değiştir'i tıklayın.
3. GCP proje numarası bölümüne Google Cloud proje numarasını yapıştırın.
4. Projeyi ayarla'yı tıklayın.

Artık deneyebileceğiniz (aşağıdaki adımlarda açıklandığı gibi) ve ardından gereksinimlerinizi karşılayacak şekilde özelleştirebileceğiniz çalışan bir uygulama kodunuz var.

Apps Komut Dosyası şablonunu açtığınızda doğru Google Hesabı'nda oturum açtığınızdan emin olun. Mevcut hesap bazen siz fark etmeden varsayılan hesabınıza geçebilir.

Test dağıtımı oluşturma

Bu Apps Komut Dosyası projesi için bir dağıtım kimliğine ihtiyacınız var. Bu kimliği sonraki adımda kullanabilirsiniz.

Ana dağıtım kimliğini almak için aşağıdakileri yapın:

1. Chat uygulaması Apps Komut Dosyası projesinde, Dağıt > Test dağıtımları'nı tıklayın.
2. Daha sonraki bir adımda kullanmak üzere Head dağıtım kimliğini kopyalayın ve Bitti'yi tıklayın.

Chat uygulamasını yayınlama

Chat uygulamasını konsoldan yayınlayın.

1. Konsolda Google Chat API simgesini arayın ve Google Chat API'yi tıklayın.
2. Yönet'i tıklayın.

3. Yapılandırma'yı tıklayın ve Chat uygulamasını ayarlayın:

   1. Uygulama adı alanına Quickstart app girin.
   2. Avatar URL'si alanına https://developers.google.com/chat/images/quickstart-app-avatar.png girin.
   3. Açıklama alanına Quickstart app girin.
   4. İşlevsellik bölümünde Alanlara ve grup görüşmelerine katılma'yı seçin.
   5. Bağlantı ayarları bölümünde Apps Komut Dosyası'nı seçin.
   6. Deployment ID (Dağıtım Kimliği) alanına, daha önce kopyaladığınız Head dağıtım kimliğini yapıştırın.
   7. Görünürlük bölümünde Alanınızdaki belirli kişiler ve gruplar'ı seçip e-postanızı girin.

4. Kaydet'i tıklayın.

Chat uygulaması, mesajlara yanıt vermeye 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:

1. Kendinizi güvenilir test kullanıcıları arasına eklerken sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.

   Google Chat'e gidin.

2. add Yeni sohbet'i tıklayın.
3. 1 veya daha fazla kişi ekle alanına Chat uygulamanızın adını yazın.

4. Sonuçlardan Chat uygulamanızı seçin. Doğrudan mesaj açılır.

5. Uygulamayla olan yeni doğrudan mesajda Hello yazıp enter tuşuna basın.

   Chat uygulaması, eklediğiniz için teşekkür eder ve mesajınızı tekrarlar.

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.

1. Google Cloud Console'da Kaynakları yönetin sayfasına gidin. Şunu tıklayın: Menü menu > IAM ve Yönetici > Kaynakları Yönetin.

   Resource Manager'a gitme

2. Proje listesinde, silmek istediğiniz projeyi seçin ve Sil'i delete tıklayın.
3. İletişim kutusunda proje kimliğini yazın ve ardından projeyi silmek için Kapat'ı tıklayın.

Sonraki adımlar

• Etkileşimli kartlar oluşturma: Kart mesajları, tanımlanmış bir düzeni, düğmeler gibi etkileşimli kullanıcı arayüzü öğelerini ve resimler gibi zengin medyaları destekler. Ayrıntılı bilgi sunmak, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adıma yönlendirmek için kart mesajlarını kullanın.
• Komutlara yanıt verme: Komutlar, kullanıcıların Chat uygulamanızın temel özelliklerini keşfetmesine ve kullanmasına yardımcı olur.
• Başlatma iletişim kutuları: İletişim kutuları, uygulamanızın kullanıcıyla etkileşim kurmak için açabileceği pencereli, kart tabanlı arayüzlerdir. Birden fazla kartı sırayla bir araya getirebilirsiniz. Bu sayede kullanıcılar, form verilerini doldurma gibi çok adımlı işlemleri tamamlayabilir.
• code Codelab: Daha gelişmiş bir sohbet uygulaması oluşturmaya hazır mısınız? Geri bildirimi inceleyin. Build apps for Google Chat with Gemini adlı codelab'deki Chat uygulaması.