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

Doğrudan mesaj gönderebileceğiniz ve mesajlarınızı çağırarak yanıt verebilecek bir Google Chat uygulaması oluşturun.

Hedefler

  • Ortamınızı ayarlayın.
  • Komut dosyasını kurun.
  • Uygulamayı yayınlayın.
  • Komut dosyasını çalıştırın.

Ön koşullar

Ortamınızı ayarlayın

Cloud projenizi Google Cloud Console'da açma

Henüz açık değilse bu örnek için kullanmak istediğiniz 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ı açmanız gerekebilir.

Chat API'yi etkinleştirme

Google API'lerini kullanmadan önce bir Google Cloud projesinde etkinleştirmeniz gerekir. Bir veya daha fazla API'yi tek bir Google Cloud projesinde etkinleştirebilirsiniz.

OAuth 2.0 kullanan tüm uygulamalar için izin ekranı yapılandırması gerekir. Uygulamanızın OAuth izin ekranını yapılandırmak, kullanıcılara ve uygulama incelemecilere nelerin gösterileceğini belirler ve daha sonra yayınlayabilmeniz için uygulamanızı kaydeder.

  1. Google Cloud Console'da Menü > API'ler ve Hizmetler > OAuth izin ekranı'na gidin.

    OAuth izin ekranına git

  2. Uygulamanızın kullanıcı türünü seçin, ardından Oluştur'u tıklayın.
  3. Uygulama kayıt formunu doldurup Kaydet ve Devam Et'i tıklayın.

  4. Şu an için kapsam eklemeyi atlayıp Kaydet ve Devam Et'i tıklayabilirsiniz. İleride, Google Workspace kuruluşunuz dışında kullanılacak bir uygulama oluşturduğunuzda, uygulamanızın gerektirdiği yetkilendirme kapsamlarını eklemeniz ve doğrulamanız gerekir.

  5. Kullanıcı türü olarak Harici'yi seçtiyseniz test kullanıcıları ekleyin:
    1. Test kullanıcıları bölümünde 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 kayıt özetinizi inceleyin. Değişiklik yapmak için Düzenle'yi tıklayın. Uygulama kaydı iyi görünüyorsa Kontrol Paneline Dön'ü tıklayın.

Komut dosyasını kurun

Komut dosyasını ayarlamak için bir şablon kullanıp Cloud projenizi Apps Komut Dosyası'nda 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ı kopyala

  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ı Apps Komut Dosyası projesinde Proje Ayarları'nı Proje ayarları simgesi 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 deneyebileceğiniz bir uygulama kodunuz vardır. Kodu aşağıdaki adımlarda açıklandığı şekilde ihtiyaçlarınıza uygun şekilde özelleştirebilirsiniz.

Apps Komut Dosyası şablonunu açtığınızda doğru Google Hesabı'nda oturum açtığınızdan emin olun. Mevcut hesap bazen siz farkına varmadan varsayılan hesabınıza geçiş yapabilir.

Test dağıtımı oluşturma

Bir sonraki adımda kullanabilmeniz için bu Apps Komut Dosyası projesinin 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ı Apps Komut Dosyası projesinde Dağıt > Test dağıtımları'nı tıklayın.
  2. Daha sonraki bir adımda kullanmak için Ana dağıtım kimliği'ni kopyalayın ve 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ı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ı kurun:

    1. Uygulama adı alanına Quickstart app girin.
    2. Avatar URL'si alanına https://developers.google.com/chat/images/quickstart-app-avatar.png girin.
    3. Açıklama alanına Quickstart app girin.
    4. İşlevler bölümünde, 1:1 mesajlar 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 ve Dağıtım Kimliğini alana yapıştırın.
    6. İzinler'in altında, Alanınızdaki belirli kişiler ve gruplar'ı seçip e-postanızı girin.

  4. Kaydet'i tıklayıp sayfayı yenileyin.

  5. Yapılandırma sayfasında, Uygulama durumu'nun altında durumu Canlı - kullanıcılar tarafından kullanılabilir olarak ayarlayın.

  6. Kaydet'i tıklayın.

Chat uygulaması mesajlara yanıt vermeye hazırdır.

Komut dosyasını çalıştır

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

Uygulama, onu eklediğiniz için teşekkür eder ve mesajınızı yansıtır.

Sonraki adımlar

  • Etkileşimli kartlar oluşturun: Kart mesajları; tanımlı bir düzeni, düğmeler gibi etkileşimli kullanıcı arayüzü öğelerini ve resimler gibi rich media öğelerini destekler. Ayrıntılı bilgi sunmak, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adıma geçmeye yönlendirmek için kart mesajlarını kullanın.
  • Dikey eğik çizgi komutları: Eğik çizgi komutları, /help gibi düz eğik çizgiyle (/) başlayan bir komut yazarak kullanıcıların uygulamanıza verebileceği belirli komutları kaydettirmenize ve yayınlamanıza olanak tanır.
  • Başlatma iletişim kutuları: İletişim kutuları, uygulamanızın bir kullanıcıyla etkileşimde bulunmak için açabileceği pencereli, kart tabanlı arayüzlerdir. Birden fazla kart sıralı bir şekilde birbirine geçirilebilir. Böylece kullanıcılar form verilerini doldurma gibi çok adımlı işlemleri tamamlamaya yardımcı olur.