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

Doğrudan mesaj gönderebileceğiniz ve mesajlarınızı tekrarlayarak 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ı ayarlayın

Cloud projenizi Google Cloud Console'da açın

Henüz açık değilse bu örnek için kullanmayı düşündüğünüz Cloud projesini açın:

  1. Google Cloud Console'da Proje seçin sayfasına gidin.

    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ı 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 için bir izin ekranı yapılandırması gerekir. Uygulamanızın OAuth izin ekranını yapılandırmak, kullanıcılara ve uygulama incelemecilerine gösterilenleri tanımlar 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 gitme

  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 Save and Continue (Kaydet ve Devam Et) seçeneğini tıklayın.

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

  5. Kullanıcı türü olarak Harici'yi seçtiyseniz 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ı girin, ardından Kaydet ve Devam Et'i tıklayın.
  6. Uygulamanızın kayıt özetini 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ı ayarlayın

Komut dosyasını ayarlamak için bir şablon kullanarak Cloud Komut Dosyası'nı Apps Komut Dosyası'nda ayarlıyorsunuz.

Şablondan komut dosyası 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ını kullanarak Google Cloud proje numarasını yapıştırın.
  4. Proje ayarla'yı tıklayın.

Şu anda deneyebileceğiniz (aşağıdaki adımlarda açıklandığı gibi) çalışan bir uygulama kodunuz vardır ve gereksinimlerinizi karşılayacak şekilde özelleştirebilirsiniz.

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ç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 > Dağıtımları test et'i tıklayın.
  2. Daha sonra kullanmak üzere Head dağıtım kimliğini kopyalayın ve Bitti'yi tıklayın.

Chat uygulamasını yayınlama

Chat uygulamasını Google Cloud Console'dan 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 yazın.
    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, Bire bir mesajlar 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 ve Dağıtım Kimliğini 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ında 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ı 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önderin.
  3. Uygulama bul sayfasında Quickstart App için arama yapın.
  4. Quickstart App (Hızlı Başlangıç Uygulaması) yanında, Chat'i tıklayın.
  5. Uygulamayla gönderilen yeni doğrudan mesajda Hello yazın ve enter tuşuna basın.

Uygulama, bu uygulamayı eklediğiniz için teşekkür ediyor ve mesajınızı yansıtıyor.

Sonraki adımlar

  • Etkileşimli kartlar oluşturma: 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ı sonraki adımı atmaya yönlendirmek için kart mesajlarını kullanın.
  • Destek eğik çizgi komutları: Eğik çizgi komutları, kullanıcıların /help gibi eğik çizgi (/) ile başlayan bir komut yazarak uygulamanıza verebileceği belirli komutları kaydetmenize ve bunların reklamını yapmanıza olanak tanır.
  • Lansman 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ırayla dizilebilir. Böylece, kullanıcılar form verilerini doldurmak gibi çok adımlı işlemleri tamamlayabilir.