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

Doğrudan mesaj gönderebileceğiniz ve mesajlarınızı yansıtarak yanıt veren bir Google Chat uygulaması oluşturun.

Hedefler

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

Ö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ın ve ekrandaki talimatları uygulayın. 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 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 bir izin ekranı yapılandırması gerektirir. Uygulamanızın OAuth izin ekranını yapılandırdığınızda kullanıcılara ve uygulama incelemecilere nelerin 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 doldurup 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 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 seçeneğini belirlediyseniz test kullanıcılarını 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ızı 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ında sorun yoksa Kontrol Paneline Dön'ü tıklayın.

Komut dosyasını ayarlayın

Komut dosyasını ayarlamak için bir şablon kullanıp 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ı 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 ayarlama

  1. Chat uygulamasının Apps Komut Dosyası projesinde Proje Ayarları'nı Proje ayarları simgesi tıklayın.
  2. Google Cloud Platform (GCP) Projesi altında, 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, aşağıdaki adımlarda açıklandığı gibi deneyebileceğiniz ve daha sonra gereksinimlerinizi karşılayacak şekilde özelleştirebileceğiniz, çalışır durumda 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

Bu Apps Komut Dosyası projesi için dağıtım kimliğine ihtiyacınız var. Böylece, bir sonraki adımda bu kimliği 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 üzere Başlık 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 yazın.
    3. Açıklama alanına Quickstart app yazın.
    4. İşlevsellik bölümünde 1:1 mesajlar 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. İzinler 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 ve sayfayı yenileyin.

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

  6. Kaydet'i tıklayın.

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

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

  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. Uygulamadaki yeni doğrudan mesajda Hello yazıp enter tuşuna basın.

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

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. Kart mesajlarıyla ayrıntılı bilgiler sunun, kullanıcılardan bilgi toplayın ve kullanıcıları bir sonraki adımı atmaya yönlendirin.
  • Destek eğik çizgi komutları: Eğik çizgi komutları, kullanıcıların öne eğik çizgiyle (/) başlayan bir komut yazarak (/help gibi) uygulamanıza verebileceği belirli komutları kaydetmenize ve tanıtmanı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 da kullanıcıların form verilerini doldurmak gibi çok adımlı işlemleri tamamlamalarına yardımcı olur.