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

Bu sayfada, Google Apps Komut Dosyası'nı kullanarak Google Chat'te çalışan bir Google Workspace eklentisinin nasıl oluşturulacağı açıklanmaktadır. Google Chat'te eklentiler kullanıcılara Google Chat uygulamaları olarak görünür. Daha fazla bilgi edinmek için Google Chat'i genişletme başlıklı makaleyi inceleyin.

Chat uygulaması, doğrudan mesaj göndermenize ve mesajlarınızı tekrarlayarak yanıt vermenize olanak tanır.

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ı için bir Google Workspace eklentisi 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ı
• 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 hızlı başlangıç projesinin bir kopyasını oluşturur ve ardından Cloud projenizi Apps Komut Dosyası'nda ayarlarsınız.

Hızlı başlangıç projesinin kopyasını oluşturma

1. Google Chat'te Eklenti Apps Script projesini açmak için aşağıdaki düğmeyi tıklayın.
   Projeyi açma
2. Genel Bakış'ı tıklayın.
3. Genel bakış sayfasında Kopya oluştur'u tıklayın.

4. Apps Komut Dosyası projesinin kopyanıza bir ad verin:

   1. Eklenti Sohbet uygulamasının kopyası'nı tıklayın.

   2. Proje başlığı'na Add-on Chat app yazın.

   3. 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 projesini 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.

Eklentiyi yapılandırma

Apps Script dağıtımınızı kullanarak eklenti oluşturmak ve Google Chat uygulamasını dağıtmak için aşağıdaki adımları uygulayı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 Add-on Chat app girin.
   2. Avatar URL'si alanına https://developers.google.com/chat/images/quickstart-app-avatar.png girin.
   3. Açıklama alanına Add-on Chat 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 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-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 eklerken 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.