Google Apps Komut Dosyası Chat uygulaması hızlı başlangıç kılavuzu

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

Aşağıdaki şemada, mimari ve mesajlaşma kalıbı gösterilmektedir:

Yukarıdaki şemada, Apps Komut Dosyası Chat uygulamasıyla etkileşimde bulunan bir kullanıcı aşağıdaki bilgi akışına sahiptir:

1. Kullanıcı, Chat uygulamasına doğrudan mesaj veya bir 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ının 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 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

• Chat'e erişimi olan bir Google Workspace hesabı.
• Bir Google Cloud projesi.

Ortamınızı ayarlama

Google Cloud Console'da Cloud projenizi açma

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

1. Google Cloud konsolunda Proje seçin sayfasına gidin.

   Cloud projesi seçin

2. Kullanmak istediğiniz Google Cloud projesini seçin. Dilerseniz Proje oluştur'u tıklayıp ekrandaki talimatları da uygulayabilirsiniz. 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 konsolunda Google Chat API'yi etkinleştirin.

  API'yi etkinleştirme

OAuth izin ekranını yapılandırın

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

1. Google Cloud konsolunda 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 ardından Oluştur'u tıklayın.
3. Uygulama kayıt formunu doldurup Kaydet ve Devam Et'i tıklayın.

4. Şimdilik kapsam eklemeyi atlayıp Kaydet ve Devam Et'i tıklayabilirsiniz. Gelecekte, Google Workspace kuruluşunuzun dışında kullanım için 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ında sorun yoksa Kontrol Paneline Dön'ü tıklayın.

Komut dosyasını ayarlama

Komut dosyasını kurmak için bir şablon kullanın ve ardından Apps Komut Dosyası'nda Cloud projenizi ayarlayın.

Şablondan komut dosyasını oluşturun

1. Apps Komut Dosyası Başlarken sayfasına gidin.
2. Chat Uygulaması şablonunu tıklayın. Bu şablonu görmek için aşağı kaydırmanız gerekebilir.
3. Adsız proje'yi tıklayın, Quickstart app yazın ve Yeniden adlandır'ı tıklayın.

Cloud projesi numarasını kopyalayın

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

   IAM ve Yönetici Ayarları'na gidin

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

Apps Komut Dosyası projesinin Cloud projesini ayarlayın

1. Chat uygulaması Apps Komut Dosyası projesinde Proje Ayarları'nı tıklayın.
2. Google Cloud Platform (GCP) Project bölümünde Projeyi değiştir seçeneğini 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 deneyebileceğiniz, çalışan bir uygulama kodunuz var (aşağıdaki adımlarda açıklandığı gibi) ve sonra bunları gereksinimlerinize göre özelleştirebilirsiniz.

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

Test dağıtımı oluşturma

Sonraki adımda kullanabilmeniz için bu Apps Komut Dosyası projesi için bir dağıtım kimliğine ihtiyacınız vardır.

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

1. Chat uygulaması Apps Komut Dosyası projesinde Dağıt > Dağıtımları test et'i tıklayın.
2. Sonraki adımda kullanmak üzere Head dağıtım kimliğini kopyalayın ve Bitti'yi tıklayın.

Chat uygulamasını yayınlama

Google Cloud konsolundan Chat uygulamasını yayınlayın.

1. Google Cloud Console'da Google Chat API araması yapı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 yazın.
   2. Avatar URL'si alanına https://developers.google.com/chat/images/quickstart-app-avatar.png yazın.
   3. Açıklama alanına Quickstart app yazın.
   4. İşlevler bölümünde Bire bir mesaj al ve Alanlara ve grup görüşmelerine katıl'ı seçin.
   5. Bağlantı ayarları bölümünde Apps Komut Dosyası projesi'ni 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çin ve e-posta adresinizi girin.

4. Kaydet'i tıklayın.

Chat uygulaması, mesajları yanıtlamaya 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 eklerken sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.

   Google Chat'e git

2. 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çlar arasından Chat uygulamanızı seçin. Bir doğrudan mesaj açılır.

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

5. Uygulamayı içeren 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ı 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.

Dikkat: Proje silmenin aşağıdaki etkileri vardır:

• Projedeki her şey silinir. Bu eğitim için mevcut bir projeyi kullandıysanız bu projeyi sildiğinizde, projede yaptığınız diğer çalışmaları da silmiş olursunuz.
• Ö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 proje içindeki seçili kaynakları silin.

Birden fazla eğiticiyi ve hızlı başlangıç kılavuzunu keşfetmeyi planlıyorsanız projeleri yeniden kullanarak proje kota sınırlarını aşmaktan kaçınabilirsiniz.

1. Google Cloud konsolunda Kaynakları yönetin sayfasına gidin. Menü > IAM ve Yönetici > Kaynakları Yönet'i tıklayın.

   Resource Manager'a git

2. Proje listesinde, silmek istediğiniz projeyi seçin ve ardından Sil simgesini 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ımlı bir düzeni, düğmeler gibi etkileşimli kullanıcı arayüzü öğelerini ve resimler gibi rich media öğelerini destekler. Ayrıntılı bilgiler sunmak, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adımı atmaya yönlendirmek için kart mesajlarını kullanın.
• Eğik çizgiyle başlayan komutlar: Eğik çizgi komutları, kullanıcıların öne eğik çizgiyle (/) (ör. /help) başlayan bir komut yazarak uygulamanıza verebileceği belirli komutları kaydetmenizi ve tanıtmanızı sağlar.
• Başlatma iletişim kutuları: İletişim kutuları, uygulamanızın bir kullanıcıyla etkileşimde bulunmak için açabileceği pencereli, kart tabanlı arayüzlerdir. Birden fazla kart sırayla bir araya getirilebilir. Böylece kullanıcılar form verilerini doldurmak gibi çok adımlı işlemleri tamamlayabilir.
• Codelab: Daha gelişmiş bir Chat uygulaması oluşturmaya hazır mısınız? Geri bildirimleri inceleyin Codelab'deki Chat uygulaması Gemini ile Google Chat için uygulama geliştirme.