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

Doğrudan mesaj gönderebileceğiniz ve mesajlarınızı hatırlatarak 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ı, doğrudan mesaj yoluyla veya bir Chat alanında Chat uygulamasına mesaj gönderir.
2. Google Cloud'da yer alan Apps Komut Dosyası'nda uygulanan Chat uygulaması mantığı, mesajı alır ve işler.
3. İsteğe bağlı olarak, Chat uygulama mantığı, Takvim veya E-Tablolar gibi Google Workspace hizmetleri veya Google Haritalar ya da YouTube gibi diğer Google Hizmetleri ile 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.

   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ı da uygulayabilirsiniz. Bir Google Cloud projesi oluşturursanız proje için faturalandırmayı etkinleştirmeniz gerekebilir.

Chat API'yi etkinleştirme

Google API'lerini kullanmadan önce bunları bir Google Cloud projesinde etkinleştirmeniz gerekir. Tek bir Google Cloud projesinde bir veya daha fazla API 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ın yapılandırılması, kullanıcılara ve uygulamayı inceleyenlere neyin 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 Oluştur'u tıklayın.
3. Uygulama kayıt formunu doldurun, ardından 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 kullanmak için bir uygulama oluşturduğunuzda Kullanıcı türü'nü Harici olarak değiştirmeniz ve 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ı sorunsuz görünüyorsa Kontrol Paneline Dön'ü tıklayın.

Komut dosyasını kurma

Komut dosyasını kurmak için bir şablon kullanırsınız. Ardından, Apps Komut Dosyası'nda Cloud projenizi ayarlarsınız.

Ş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 sayfayı 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 proje numarasını kopyalayın

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

   IAM ve Yönetici Ayarları'na git

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

Apps Komut Dosyası projesinin Cloud projesini ayarlayın

1. Chat uygulamasının Apps Komut Dosyası projesinde Proje Ayarları'nı tıklayın.
2. Google Cloud Platform (GCP) Project (Google Cloud Platform (GCP) Projesi) bölümünde Change project (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, aşağıdaki adımlarda açıklandığı gibi deneyebileceğiniz, ardından gereksinimlerinizi karşılayacak şekilde özelleştirebileceğiniz, çalışan bir uygulama kodunuz vardır.

Apps Komut Dosyası şablonunu açtığınızda 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çebilir.

Test dağıtımı oluşturma

Bir sonraki adımda kullanabilmeniz için bu Apps Komut Dosyası projesinde dağıtım kimliğine ihtiyacınız var.

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 üzere Head dağıtım kimliğini kopyalayıp Bitti'yi tıklayın.

Chat uygulamasını yayınlama

Google Cloud Console'dan Chat uygulamasını yayınlayın.

1. Google Cloud Console'da Google Chat API araması yapıp 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 (Avatar URL'si) alanına https://developers.google.com/chat/images/quickstart-app-avatar.png girin.
   3. Description (Açıklama) alanına Quickstart app yazın.
   4. İşlev 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 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ı 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 bir 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 kişi ekle alanına Chat uygulamanızın adını yazın.

4. Sonuçlardan Chat uygulamanızı seçin. Bir doğrudan mesaj açılır.

   Not: Sonuçlar listesinde Chat uygulamanızı görmüyorsanız Google Workspace hesabınızı Google Cloud Console'da, 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 mesajda Hello yazıp enter tuşlarına basın.

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

Chat kullanıcı arayüzünde bir hata mesajı gösterilmese de, Chat uygulamaları için hata günlük kaydı etkinken hataları düzeltmenize yardımcı olacak açıklayıcı hata mesajları ve günlük verileri mevcuttur. Hataları görüntüleme, hata ayıklama ve düzeltme konusunda yardım için Google Chat hatalarını giderme ve düzeltme bölümünü inceleyin.

Temizleme

Bu eğiticide kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini istemiyorsanız Cloud projesini silmenizi öneririz.

Dikkat: Projeyi silmenin etkileri aşağıdaki gibidir:

• 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 tüm çalışmaları da silmiş olursunuz.
• Özel proje kimlikleri kaybolur. Bu projeyi oluşturduğunuzda, ileride 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 projenin içindeki seçili kaynakları silin.

Birden fazla eğiticiyi ve hızlı başlangıç kılavuzunu incelemeyi planlıyorsanız projeleri yeniden kullanmak, proje kota sınırlarını aşmanızı önlemeye yardımcı olabilir.

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 listesinden silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
3. İletişim kutusuna proje kimliğini yazın, ardından 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 rich media öğelerini destekler. Kart mesajlarını ayrıntılı bilgi sunmak, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adıma geçmeye yönlendirmek için kullanın.
• Eğik çizgi komutlarını destekleyin: Eğik çizgi komutları, kullanıcıların düz eğik çizgi (/) ile başlayan bir komut yazarak (/help gibi) uygulamanıza verebileceği belirli komutları kaydetmenize ve reklamını yapmanıza olanak tanır.
• 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 art arda sıralanabilir. Bu, kullanıcıların form verilerini doldurmak gibi çok adımlı işlemleri tamamlamalarına yardımcı olur.