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

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:

Apps Komut Dosyası ile uygulanan bir Chat uygulaması mimarisi.

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

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.

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. Uygulamanızın kullanıcı türünü seçin, ardından 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, uygulamanızın gerektirdiği yetkilendirme kapsamlarını eklemeniz ve doğrulamanız gerekir.

  5. Kullanıcı türü için Harici'yi seçtiyseniz test kullanıcıları ekleyin:
    1. Test kullanıcıları'nın altında Kullanıcı ekle'yi tıklayın.
    2. E-posta adresinizi ve diğer yetkili test kullanıcılarını girip Kaydet ve Devam Et'i tıklayın.
  6. 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 Console'da Cloud projenize gidin.
  2. Ayarlar ve Yardımcı Programlar > Proje ayarları'nı tıklayın.
  3. Proje numarası'nı kopyalayın.

Apps Komut Dosyası projesinin Cloud projesini ayarlayın

  1. Chat uygulamasının Apps Komut Dosyası projesinde Proje Ayarları'nı Proje ayarları simgesi 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. Connection settings (Bağlantı ayarları) bölümünde Apps Komut Dosyası projesi'ni seçin ve Dağıtım Kimliği'ni alana yapıştırın.
    6. 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 ve sayfayı yenileyin.

  5. Yapılandırma sayfasındaki Uygulama durumu'nun altında durumu Yayında - kullanıcılara açık olarak ayarlayın.

  6. Kaydet'i tıklayın.

Chat uygulaması mesajları yanıtlamaya hazırdır.

Chat uygulamasını test etme

  1. Chat'i açın.
  2. Sohbet başlat > Uygulama bul'u tıklayarak uygulamaya yeni bir doğrudan mesaj gönderin.
  3. Uygulama bul sayfasında Quickstart App araması yapın.
  4. Quickstart App'in (Hızlı Başlangıç Uygulaması) yanındaki Chat'i tıklayın.
  5. Uygulamayla olan yeni doğrudan mesajda Hello yazıp enter tuşuna 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.

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.