Bir Google Chat uygulamasını yapılandırma

Bu sayfada, Google Chat uygulamasının Google Workspace eklentisi olarak nasıl yapılandırılacağı ve dağıtılacağı açıklanmaktadır.

Chat'i genişleten bir Google Workspace eklentisini dağıtmak ve test etmek için Google Chat API'yi kullanarak bir Chat uygulamasını etkinleştirmeniz ve yapılandırmanız gerekir. Chat API yapılandırma ayarlarında; ad, avatar, dağıtım ve kullanmak istediğiniz etkileşimli özellikler dahil olmak üzere Chat uygulamasıyla ilgili tüm ayrıntıları belirtirsiniz.

Ön koşullar

HTTP

Apps Komut Dosyası

Chat uygulamanız için görünen ad, avatar ve açıklama seçme

Chat uygulamasının adı, avatarı ve açıklaması, Chat kullanıcı arayüzünde kullanıcılara gösterilir. Kullanıcılar, sohbet uygulamalarıyla etkileşime geçmek için bu bilgileri aşağıdaki şekillerde görür veya kullanır:

  • Chat uygulamasını bir alana eklemek veya uygulamaya mesaj göndermek için @bahsetme özelliğini kullanın.
  • Chat uygulamasıyla doğrudan mesaj bulup başlatın. Uygulamalar menüsünde, doğrudan mesajlarda Chat uygulamasının adı ve avatarı gösterilir.
  • Kullanıcılar, oluşturma çubuğundan Chat uygulamalarına göz atabilir ve adlarını, avatarlarını ve açıklamalarını görebilir.

Chat uygulamasını yapılandırmadan önce aşağıdaki bilgileri hazırlamanız gerekir:

Alan Açıklama Biçim
Uygulama adı Chat uygulamasının görünen adı. En fazla 25 alfanümerik karakter
Avatar URL'si Chat uygulamanızın avatarı olarak gösterilen resim. Kare bir grafik resmine (PNG veya JPEG) yönlendiren bir HTTPS URL'si. Önerilen boyut 256x256 piksel veya daha büyüktür.
Açıklama Chat uygulamasının amacının kısa bir açıklaması. En fazla 40 alfanümerik karakter

Aşağıdaki bölümde, Chat API'deki yapılandırma ayarlarında bu bilgileri belirtirsiniz.

Google Cloud Console'da Chat uygulamanızı yapılandırma

Chat uygulaması ayrıntılarınız hazır olduğunda Cloud projenizi açıp Chat API'yi yapılandırın:

  1. Google Cloud Console'da Chat API sayfasına gidin ve Yapılandırma sayfasını tıklayın:

    Chat API Yapılandırması sayfasına gidin

  2. Uygulama bilgileri bölümünde Uygulama adı, Avatar URL'si ve Açıklama alanlarını doldurun.

  3. Etkileşimli özellikler bölümünde, Etkileşimli özellikleri etkinleştir'i tıklayarak etkinleştirin ve aşağıdakileri tamamlayın:

    1. İşlevsellik bölümünde, Chat uygulamanızın yüklenip kullanılabilmesi için bir veya daha fazla onay kutusunu işaretleyin:

      • Bire bir mesaj alma: Kullanıcılar, Chat uygulamasını yükleyip kullanıcı ile Chat uygulaması arasında özel bir alanda mesajlaşabilir.

      • Alanlara ve grup görüşmelerine katılma: Kullanıcılar, birden fazla kullanıcının bulunduğu alanlara Chat uygulamasını ekleyebilir ve bu uygulamayla etkileşim kurabilir.

    2. Bağlantı ayarları bölümünde, Chat'ten etkinlik nesneleri almak için kullanmak istediğiniz mimariyi seçin:

      • HTTP hizmeti kullanmak için HTTP uç noktası URL'si'ni seçin ve bir URL girin.
      • Google Apps Komut Dosyası projesi kullanmak için Apps Komut Dosyası'nı seçin ve proje için bir dağıtım kimliği sağlayın.

    3. İsteğe bağlı: Birden fazla uç noktaya veya işleve etkinlik nesneleri almak için Gelişmiş ayarlar > Tetikleyiciler'e gidin ve aşağıdaki sohbet tetikleyicileri için geri çağırma işlevlerini sağlayın veya güncelleyin:

      • ADDED_TO_SPACE: Kullanıcı, Chat uygulamasını bir grup görüşmesine veya alana ekler ya da 1:1 mesajlar için Chat uygulamasını yükler.
      • MESSAGE: Kullanıcı Chat uygulamasına mesaj gönderir. Örneğin, Chat uygulamasına doğrudan mesaj gönderir veya birden fazla kullanıcının bulunduğu bir alanda Chat uygulamasına @bahsetme yapar.
      • REMOVED_FROM_SPACE: Bir kullanıcı Chat uygulamasını kaldırır veya alandan çıkarır.

    4. İsteğe bağlı: / komutları veya bağlantı önizlemeleri gibi diğer etkileşimli özellikleri ekleyin.

    5. Google Workspace Marketplace'te yayınlamadan önce Chat uygulamasını yükleyip test edebilmeniz için Görünürlük bölümünde e-postanızı belirtin. Google Workspace kuruluşunuzdan beş adede kadar kullanıcı veya bir veya daha fazla Google grubu belirtebilirsiniz.

  4. İsteğe bağlı: Google Cloud Logging'i kullanmak için Günlükler bölümünde Hata günlüklerini Logging'e kaydet onay kutusunu işaretleyin. Daha fazla bilgi için Chat API dokümanlarında Chat uygulamaları için sorgu hatası günlükleri bölümüne bakın.

  5. Kaydet'i tıklayın.

Yapılandırmayı kaydettikten sonra Chat API'nin Görünürlük ayarlarında belirttiğiniz herkes Chat uygulamasını yükleyebilir, test edebilir veya kullanabilir. Chat uygulamanızı test etmeye ve hata ayıklamaya başlamak için Chat API dokümanlarında Google Chat uygulamaları için etkileşimli özellikleri test etme bölümüne bakın.

Mevcut Google Workspace eklentileriyle ilgili dikkat edilmesi gereken noktalar

Chat uygulamaları, diğer Google Workspace uygulamalarını genişleten Google Workspace eklentilerine kıyasla farklı bir yapılandırma gerektirir. Eklentiniz diğer Google Workspace uygulamalarını genişletiyorsa Chat uygulamasını yapılandırmak için aşağıdaki koşulları göz önünde bulundurun:

  • Hem kullanıcılar hem de Google Workspace yöneticileri, eklentinizi Marketplace'ten yükleyebilmelidir. Bu yükleme ayarlarını Google Workspace Marketplace SDK'sında yapılandırırsınız.
  • Chat uygulamaları, manifest dosyasının addons.common nesnesinde diğer Google Workspace uygulamaları için yapılandırdığınız adı ve logoyu kullanmaz.
  • Google Workspace Marketplace'te yayınlanan eklentilerde, Google Chat API yapılandırma ayarlarında yapılan değişikliklerin taslağını kaydedemezsiniz. Chat API yapılandırma ayarlarını güncelleyip kaydettikten sonra güncellenmiş Chat uygulaması mevcut tüm kullanıcılar tarafından kullanılabilir. Marketplace girişinizi güncellemek için herhangi bir değişiklik göndermeden önce taslak oluşturabilirsiniz.

  • Eklentinizi Apps Komut Dosyası'nı kullanarak oluşturduysanız:

  • Eklentinizi bir HTTP hizmeti kullanarak oluşturduysanız Google Workspace eklentileri API'sini kullanarak oluşturduğunuz manifest ve dağıtımlardaki Chat uygulaması yapılandırma ayrıntılarını çıkarın. Google Workspace Marketplace SDK'sında belirttiğiniz HTTP dağıtımları yalnızca diğer Google Workspace uygulamaları için kullanılır.