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 kalıbı gösterilmektedir:

Önceki şemada, bir Apps Komut Dosyası Chat uygulamasıyla etkileşimde bulunan kullanıcının bilgi akışı aşağıdaki gibidir:

1. Kullanıcı, Chat uygulamasına doğrudan mesaj veya Chat alanında 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ığı, Takvim veya E-Tablolar gibi Google Workspace hizmetleriyle ya da Google Haritalar veya YouTube gibi diğer Google hizmetleriyle entegre edilebilir.
4. Chat uygulaması mantığı, Chat'teki Chat uygulaması hizmetine bir 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ı
• Bir Google Cloud projesi. Proje 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çma

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.

   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 izin ekranını yapılandırma

OAuth 2.0 kullanan tüm uygulamalar için bir izin ekranı yapılandırması gerekir. Uygulamanızın OAuth izin ekranını yapılandırarak kullanıcılara ve uygulama yorumcularına nelerin gösterileceğini tanımlayabilir ve uygulamanızı daha sonra yayınlayabilmek için kaydedebilirsiniz.

1. Google Cloud Console'da Menü > API'ler ve Hizmetler > OAuth izin ekranı'na gidin.

   OAuth izin ekranına gidin

2. Kullanıcı türü için Dahili'yi seçin ve Oluştur'u tıklayın.
3. Uygulama kayıt formunu doldurup Kaydet ve Devam Et'i tıklayın.

4. Şimdilik kapsam eklemeyi atlayabilir ve Kaydet ve Devam Et'i tıklayabilirsiniz. Gelecekte, Google Workspace kuruluşunuzun dışında kullanılacak bir uygulama oluşturduğunuzda Kullanıcı türü'nü Harici olarak değiştirmeniz ve ardından uygulamanızın gerektirdiği yetkilendirme kapsamlarını eklemeniz gerekir.

5. Uygulama kaydı özetinizi inceleyin. Değişiklik yapmak için Düzenle'yi tıklayın. Uygulama kaydının sorunsuz görünmesi durumunda Kontrol paneline dön'ü tıklayın.

Komut dosyasını ayarlama

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

Şablondan komut dosyasını oluşturma

1. Apps Komut Dosyası Başlangıç sayfasına gidin.
2. Sayfanın alt kısmındaki Sohbet Uygulaması ş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ı kopyalama

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

   IAM ve Yönetici Ayarları'na gidin

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

Apps Komut Dosyası projesinin Cloud projesini ayarlama

1. Chat uygulamasının 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ı alanına Google Cloud proje numarasını yapıştırın.
4. Proje ayarla'yı tıklayın.

Artık deneyebilir (aşağıdaki adımlarda açıklandığı gibi) ve ardından gereksinimlerinizi karşılayacak şekilde özelleştirebilirsiniz.

Apps Script şablonunu açarken 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 vardır. Bu kimliği sonraki adımda kullanabilirsiniz.

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

1. Chat uygulamasının Apps Komut Dosyası projesinde Dağıt > Dağıtımları test et'i tıklayın.
2. Daha sonraki bir adımda kullanmak için Baş 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'yi 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 yazın.
   4. İşlevsellik bölümünde 1:1 mesaj alma ve Alanlara ve grup görüşmelerine katılma'yı seçin.
   5. Bağlantı ayarları bölümünde Apps Script'i seçin.
   6. Dağıtım Kimliği alanına, daha önce kopyaladığınız ana 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çin ve 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 bir doğrudan mesaj alanı açın ve mesaj gönderin:

1. Kendinizi güvenilir test kullanıcısı olarak eklediğinizde sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.

   Google Chat'e gidin

2. Yeni sohbet'i tıklayın.
3. 1 veya daha fazla kullanıcı 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.

   Not: Chat uygulamanızı sonuç listesinde görmüyorsanız Google Workspace hesabınızı, Google Cloud Console'daki Chat API Yapılandırması sayfasının Görünürlük ayarlarına eklediğinizden emin olun.

5. Uygulamayla olan yeni doğrudan mesaja Hello yazın ve 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ı 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

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ç verir. Örneğin, kart mesajı görünmeyebilir.

Chat kullanıcı arayüzünde hata mesajı gösterilmeyebilir ancak Chat uygulamaları için hata günlüğü 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, hata ayıklama ve düzeltme hakkında yardım için Google Chat hatalarını giderme 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.

Dikkat: Bir projeyi silmenin sonuçları şunlardır:

• Projedeki her şey silinir. Bu eğitim için mevcut bir proje kullandıysanız projeyi sildiğinizde projede yaptığınız diğer çalışmaları da silersiniz.
• Özel proje kimlikleri kaybolur. Bu projeyi oluştururken gelecekte kullanmak istediğiniz özel bir proje kimliği oluşturmuş olabilirsiniz. Proje kimliğini kullanan URL'leri (ör. appspot.com'daki bir URL) korumak için projenin tamamını silmek yerine projedeki seçili kaynakları silin.

Birden fazla eğitim ve hızlı başlangıç kılavuzunu keşfetmeyi planlıyorsanız projeleri yeniden kullanmak, proje kotası sınırlarını aşmanızı önleyebilir.

1. 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 gidin

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

Sonraki adımlar

• Etkileşimli kartlar oluşturun: Kart mesajları, tanımlanmış bir düzeni, düğmeler gibi etkileşimli kullanıcı arayüzü öğelerini ve resimler gibi zengin medyayı 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.
• Eğik çizgi komutlarını destekleme: Eğik çizgi komutları, kullanıcıların /help gibi eğik çizgiyle (/) başlayan bir komut yazarak uygulamanıza verebileceği belirli komutları kaydettirmenize ve tanıtmanıza olanak tanır.
• İletişim kutuları başlatma: İletişim kutuları, uygulamanızın kullanıcıyla etkileşime geçmek için açabileceği pencereli, kart tabanlı arayüzlerdir. Birden fazla kart sırayla birbirine bağlanabilir. Bu, kullanıcıların form verilerini doldurma gibi çok adımlı işlemleri tamamlamasına yardımcı olur.
• Codelab: Daha gelişmiş bir Chat uygulaması oluşturmaya hazır mısınız? Gemini ile Google Chat için uygulama oluşturma kod laboratuvarındaki Chat uygulamasına verilen geri bildirimi inceleyin.