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

Doğrudan mesaj gönderebileceğiniz bir Google Chat uygulaması oluşturun. mesajınızı tekrarlayarak yanıt verir.

Aşağıdaki şemada, mimari ve mesajlaşma kalıbı gösterilmektedir:

Apps Komut Dosyası ile uygulanmış bir Chat uygulamasının mimarisi.

Önceki şemada, Apps Komut Dosyası ile etkileşimde bulunan bir kullanıcı Chat uygulamasında aşağıdaki bilgi akışı bulunur:

  1. Kullanıcı Chat uygulamasına doğrudan mesaj göndererek veya Chat alanında
  2. Şurada uygulanan Chat uygulaması mantığı: Google Cloud'da bulunan Apps Komut Dosyası, ve iletiyi işler.
  3. İsteğe bağlı olarak, Chat uygulaması mantığı Takvim veya E-Tablolar ve Google Haritalar gibi diğer Google hizmetleri veya YouTube'da gösterilebilir.
  4. Chat uygulaması mantığı, Chat'te Chat uygulaması hizmeti.
  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

Açık değilse kullanmayı düşündüğünüz Cloud projesini açın şu örnekteki gibi:

  1. Google Cloud konsolunda Proje seçin sayfasına gidin.

    Cloud projesi seçin

  2. Kullanmak istediğiniz Google Cloud projesini seçin. İsterseniz Proje oluştur'u tıklayıp ekrandaki talimatları da uygulayabilirsiniz. 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'yi etkinleştirebilirsiniz.

OAuth 2.0 kullanan tüm uygulamalar, izin ekranı yapılandırması gerektirir. Yapılandırılıyor uygulamanızın OAuth izin ekranı, kullanıcılara ve uygulamaya nelerin gösterileceğini tanımlar incelemecileri belirler ve daha sonra yayınlayabilmeniz için uygulamanızı kaydeder.

  1. Google Cloud konsolunda Menü'ye gidin > API'lar ve Hizmetler > OAuth izin ekranı.

    OAuth izin ekranına gidin.

  2. Kullanıcı türü için Dahili'yi seçin ve 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şu kullanıyorsanız Kullanıcı türü'nü Harici olarak değiştirmeniz ve ardından Uygulamanızın gerektirdiği yetkilendirme kapsamlarını ekleyin.

  5. Uygulama kaydı özetinizi inceleyin. Değişiklik yapmak için Düzenle'yi tıklayın. Uygulama Kontrol Paneline Dön'ü tıklayın.

Komut dosyasını ayarlama

Komut dosyasını ayarlamak için bir şablon kullanırsınız ve ardından, Apps Komut Dosyası'ndaki Cloud projesi.

Şablondan komut dosyasını oluşturun

  1. Şuraya gidin: Apps Komut Dosyası Başlarken sayfası.
  2. Chat Uygulaması şablonunu tıklayın. Aşağı kaydırmanız gerekebilir bu şablonu görmek için.
  3. Adsız proje'yi tıklayın, Quickstart app yazın ve Yeniden adlandır'ı tıklayın.

Cloud projesi numarasını kopyalayın

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

    IAM ve Yönetici Ayarları

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

Apps Komut Dosyası projesinin Cloud projesini ayarlayın

  1. Chat uygulamasında Apps Komut Dosyası projesinde Proje Ayarları'nı Proje ayarları simgesi tıklayın.
  2. Google Cloud Platform (GCP) Project bölümünde 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 deneyebileceğiniz çalışan bir uygulama kodunuz var (bkz. adımları uygulayın) ve ardından gereksinimlerinizi karşılayacak şekilde özelleştirin.

Apps Komut Dosyası şablonu. Mevcut hesap bazen varsayılan hesabınız olabilir.

Test dağıtımı oluşturma

Bu Apps Komut Dosyası projesi için dağıtım kimliğinizin olması gerekir. sonraki adımda kullanabilirsiniz.

Head dağıtım kimliğini almak için aşağıdakileri yapın:

  1. Chat uygulamasında Apps Komut Dosyası projesinde Dağıt'ı tıklayın > Dağıtımları test edin.
  2. Sonraki adımda kullanmak üzere Head dağıtım kimliğini kopyalayın ve Bitti'yi tıklayın.

Chat uygulamasını yayınlama

Google Cloud konsolundan Chat uygulamasını yayınlayın.

  1. Google Cloud konsolunuza 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ı ayarlayın:

    1. Uygulama adı alanına Quickstart app yazın.
    2. Avatar URL'si alanına şunu girin: https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. Açıklama alanına Quickstart app yazın.
    4. İşlevsellik bölümünde 1:1 mesajlar al'ı seçin ve Alanlara ve grup görüşmelerine katılabilirsiniz.
    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, oluşturduğunuz Head dağıtım kimliğini yapıştırın. daha önce kopyalandı.
    7. Görünürlük bölümünde, Hesabınızdaki belirli kişiler ve gruplar alanınız 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 bir doğrudan mesaj alanı açın: uygulamasını kullanarak mesaj gönderebilirsiniz:

  1. Oluşturduğunuz Google Workspace hesabını kullanarak Google Chat'i açın ve kendinizi güvenilir test kullanıcısı olarak eklediğinizde sağlanan bir değerdir.

    Google Chat'e git

  2. Yeni sohbet'i tıklayın.
  3. 1 veya daha fazla kişi ekle alanına eklemek istediğiniz kişinin adını Chat uygulaması.
  4. Sonuçlar arasından Chat uygulamanızı seçin. Doğrudan mesajı açılır.

  5. Uygulamayı içeren yeni doğrudan mesajda Hello yazın ve enter tuşuna basın.

    Chat uygulaması, eklediğiniz için teşekkür ediyor mesajınıza dikkat edin.

Güvenilir test kullanıcıları eklemek ve etkileşimli özellikleri test etme hakkında daha fazla bilgi edinmek için bkz. Şunun için etkileşimli özellikleri test edin: Google Chat uygulamaları.

Sorun giderme

Bir Google Chat uygulaması veya card bir hata döndürürse Chat arayüzünde "Bir sorun oluştu" mesajı gösteriliyor. veya "İsteğiniz işlenemiyor." Chat kullanıcı arayüzü herhangi bir hata mesajı görüntülenmiyor ancak Chat uygulaması veya kart beklenmeyen bir sonuç veriyorsa; Örneğin karttaki bir mesajda görünür.

Chat kullanıcı arayüzünde hata mesajı görüntülenmese de Hataları düzeltmenize yardımcı olmak için açıklayıcı hata mesajları ve günlük verileri sunulur Chat uygulamaları için hata günlük kaydı etkinleştirildiğinde. Görüntüleme konusunda yardım için ve hataları düzeltme ile ilgili daha fazla bilgi edinmek için Google Chat hatalarını giderme ve düzeltme

Temizleme

Aşağıdaki işlem için Google Cloud hesabınızdan ücret alınmasını önlemek amacıyla: kaynaklardan yararlanabilmeniz için Cloud projesi.

  1. Google Cloud konsolunda Kaynakları yönetin sayfasına gidin. Sonraki slayta geçin Menü > IAM ve Yönetici > Kaynakları Yönetin.

    Resource Manager'a git 'nı inceleyin.

  2. Proje listesinden silmek istediğiniz projeyi seçin ve ardından Sil: .
  3. İletişim kutusuna proje kimliğini yazın ve silmek için Kapat'ı tıklayın gösterir.

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 resim gibi rich media unsurları. Kart mesajlarını kullanarak ayrıntılı bilgiler, kullanıcılardan bilgi toplamak ve kullanıcıları bir sonraki adımı atmaya yönlendirmektir.
  • Destek eğik çizgi komutları: Eğik çizgi komutları, Kullanıcıların uygulamanıza verebileceği belirli komutları kaydedip bunların reklamını yapma eğik çizgi (/) ile başlayan, /help gibi bir komut yazarak başlayın.
  • İletişim kutularını başlat: İletişim kutuları pencereli, kart tabanlıdır uygulamanızın bir kullanıcıyla etkileşimde bulunmak için açabileceği arayüzler. Birden fazla kart art arda sıralanabilir; bu da kullanıcıların birkaç adımda çeşitli işlemler gerçekleştirebilirsiniz.
  • . Codelab: Daha gelişmiş bir kod Chat uygulaması mı? Geri bildirimi inceleyin codelab'den Chat uygulaması Gemini ile Google Chat için uygulama geliştirme