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

Bu sayfada, Google Apps Komut Dosyası'nı kullanarak Google Chat uygulaması oluşturma açıklanmaktadır. Chat uygulaması, doğrudan mesaj göndermenize olanak tanır ve mesajlarınızı tekrarlayarak yanıt verir.

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

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

1. Bir kullanıcı, bir Chat uygulamasına doğrudan mesaj yoluyla ya da 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ı 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ı yapılandırı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. 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çı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 Cloud 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 kullanıcı rızası ekranını yapılandırma

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

1. Google API Konsolu'nda Menü menu > Google Auth platform > Markalama'ya gidin.

   Markalama'ya gidin.

2. Google Auth platformunu zaten yapılandırdıysanız Markalama, Kitle ve Veri Erişimi'nde aşağıdaki OAuth kullanıcı rızası ekranı ayarlarını yapılandırabilirsiniz. Google Auth platformu 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 izinleriyle 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 Şirket içi'ni 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 edinmek için OAuth kullanıcı rızası ekranını yapılandırma başlıklı makalenin tamamını inceleyin.

Komut dosyasını ayarlama

Komut dosyasını ayarlamak için Apps Komut Dosyası Başlangıç sayfasındaki Chat uygulaması şablonunu kullanırsınız.

Apps Komut Dosyası projesini oluşturma

1. Apps Komut Dosyası'nın Başlangıç sayfasında Google Workspace eklenti başlangıçları'na gidin ve Chat uygulaması şablonunu tıklayın:

   Chat uygulaması şablonunu açma

2. Açılan yeni Apps Komut Dosyası projesine ad verin:

   1. Başlıksız proje'yi tıklayın.

   2. Proje başlığı'na Quickstart app yazın.

   3. Yeniden adlandır'ı tıklayın.

Gelecekte belirli Google API'lerini kullanmak veya uygulamanızı yayınlamak isterseniz Cloud projenizi Apps Komut Dosyası projenizle ilişkilendirmeniz gerekir. Bu kılavuz için bunu yapmanız gerekmez. Daha fazla bilgi edinmek için Google Cloud projeleri kılavuzuna bakın.

Test dağıtımı oluşturma

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

Baş 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. Sonraki bir adımda kullanmak üzere Head deployment ID'yi (Baş dağıtım kimliği) kopyalayın ve Done'ı (Bitti) tıklayın.

Chat uygulamasını yapılandırma

Google Chat uygulamasını yapılandırmak için aşağıdaki adımları uygulayın:

1. API Konsolu'nda Google Chat API ifadesini 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/workspace/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ı 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çip e-postanızı 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 doğrudan mesaj alanı açın ve 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 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ı yineler.

Güvenilir test kullanıcıları ekleme ve etkileşimli özellikleri test etme hakkında daha fazla bilgi edinmek için Google Chat uygulamalarında 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" veya "İsteğiniz işlenemiyor" mesajı gösterilir. 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, hata ayıklama ve düzeltmeyle ilgili 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ızdan ücret alınmasını önlemek istiyorsanız Cloud projesini silmenizi öneririz.

1. Google API Konsolu'nda Kaynakları yönet sayfasına gidin. Şunu tıklayın: Menü menu > IAM & Admin > Kaynakları Yönetin.

   Kaynak Yöneticisi'ne gidin

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 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 getirilebilir. 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? Build apps for Google Chat with Gemini (Gemini ile Google Chat için uygulama geliştirme) adlı codelab'deki geri bildirimler bölümüne bakın.