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

Bu sayfada, Google Apps Komut Dosyası kullanarak Google Chat uygulaması oluşturma adımları 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, Apps Komut Dosyası Chat uygulamasıyla etkileşimde bulunan bir kullanıcının bilgi akışı gösterilmektedir:

1. 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 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ı 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 bölümüne bakın.

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.

   Cloud projesi seçme

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ırarak kullanıcılara ve uygulama inceleme uzmanlarına nelerin gösterileceğini tanımlar ve uygulamanızı daha sonra yayınlayabilmek için kaydetmiş olursunuz.

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

   Markalama'ya gidin

2. Google Auth platformunu daha önce yapılandırdıysanız Markalama, Kitle ve Veri Erişimi bölümlerinde aşağıdaki OAuth kullanıcı rızası ekranı ayarlarını yapılandırabilirsiniz. Google Auth platform not configured yet (Google Auth platformu henüz yapılandırılmadı) mesajını görürseniz Get Started'ı (Başlayın) tıklayın:
1. Uygulama Bilgileri bölümündeki Uygulama adı alanına uygulama için bir ad girin.
2. Kullanıcı destek e-postası bölümünde, kullanıcıların izinleriyle ilgili soruları olduğunda sizinle iletişime geçebilecekleri 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, projenizle ilgili değişiklikler hakkında 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 ekleme adımını 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 iznini yapılandırma kılavuzunun tamamını inceleyin.

Komut dosyasını ayarlama

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

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ı projesinde projeye bir ad verin:

   1. Adsız proje'yi tıklayın.

   2. Proje başlığı alanı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ılavuzunu inceleyin.

Test dağıtımı oluşturma

Bir sonraki adımda kullanabilmek için bu Apps Komut Dosyası projesinin 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. Daha 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. Configuration'ı (Yapılandırma) tıklayın ve Chat uygulamasını ayarlayın:

   1. Uygulama adı alanına Quickstart app yazın.
   2. Avatar URL (Avatar URL'si) alanına https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png değerini girin.
   3. Açıklama alanına Quickstart app yazın.
   4. İşlev 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. 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-posta adresinizi 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 mesaj alanı açın ve mesaj gönderin:

1. Kendinizi güvenilir test kullanıcısı olarak eklerken belirttiğiniz 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 kişi ekleyin 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 API Konsolu'ndaki 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. Uygulamayla olan yeni doğrudan mesajda Hello yazın ve enter tuşuna basın.

   Chat uygulaması, kendisini 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" 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ö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 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ızdan ücret alınmasını önlemek amacıyla Cloud projesini silmenizi öneririz.

Dikkat: Bir projeyi silmenin aşağıdaki etkileri olur:

• Projedeki her şey silinir. Bu eğitim için mevcut bir projeyi 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 incelemeyi planlıyorsanız projeleri yeniden kullanmak, proje kota sınırlarını aşmanızı önleyebilir.

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

   Kaynak Yöneticisi'ne git

2. Proje listesinde, silmek istediğiniz projeyi seçin ve 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şturma: Kart mesajları, tanımlı bir düzeni, düğmeler gibi etkileşimli kullanıcı arayüzü öğelerini ve resimler gibi rich media'yı destekler. Ayrıntılı bilgi sunmak, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adımı atmaya 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.
• İletişim kutularını başlatma: İ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ıralı olarak 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 geliştirme codelab'indeki geri bildirim Chat uygulamasına bakın.

Eklenti olmayan Chat uygulamaları: Google Apps Komut Dosyası ile Google Chat uygulaması oluşturma

Apps Komut Dosyası ile Google Workspace eklentisi olmayan bir Chat uygulaması oluşturmak için aşağıdaki adımları uygulayarak şablondan komut dosyasını oluşturun ve eklenti olmayan Chat uygulamasını yapılandırın.

Şablondan senaryo oluşturma

1. Chat uygulaması şablonunu açma

2. Untitled project'i (Adsız proje) tıklayın, Quickstart app yazın ve Rename'i (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.

3. Chat uygulaması Apps Komut Dosyası projesinde Dağıt > Dağıtımları test et'i tıklayın.

4. Sonraki adımda kullanmak için Head deployment ID'yi (Baş dağıtım kimliği) kopyalayın ve Done'ı (Bitti) tıklayın.

Eklenti olmayan Chat uygulamasını yapılandırma

Eklenti olmayan Chat uygulamasını API Console'dan yapılandırın:

1. API Konsolu'nda Google Chat API için arama 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 eklenti olmayan Chat uygulamasını ayarlayın:

   1. Bu Chat uygulamasını Google Workspace eklentisi olarak oluştur seçeneğinin işaretini kaldırın. Onaylamanızı isteyen bir iletişim kutusu açılır. İletişim kutusunda Devre dışı bırak'ı tıklayın.
   2. Uygulama adı alanına Quickstart app yazın.
   3. Avatar URL (Avatar URL'si) alanına https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png değerini girin.
   4. Açıklama alanına Quickstart app yazın.
   5. İşlev bölümünde Alanlara ve grup görüşmelerine katılma'yı seçin.
   6. Bağlantı ayarları bölümünde Apps Komut Dosyası'nı seçin.
   7. Dağıtım kimliği alanına, daha önce kopyaladığınız ana dağıtım kimliğini yapıştırın.
   8. 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.