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

Bu sayfada, Google Chat uygulamasının Google Workspace eklentisi olarak nasıl yapılandırılıp 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ştirip yapılandırmanız gerekir. Chat API yapılandırma ayarları, kullanmak istediğiniz ad, avatar, dağıtım ve etkileşimli özellikler de dahil olmak üzere Chat uygulamasıyla ilgili tüm ayrıntıları belirttiğiniz yerdir.

Not: Bu sayfada, Apps Komut Dosyası veya bir HTTP hizmeti kullanarak Chat uygulamasının nasıl yapılandırılacağı açıklanmaktadır. Dialogflow ve Pub/Sub kullanılamıyor. Ayrıntılar için Sınırlamalar ve bilinen sorunlar başlıklı makaleyi inceleyin.

Ön koşullar

• Google Chat'e erişimi olan bir Business veya Enterprise Google Workspace hesabı.
• Google Cloud projesi oluşturun.
• OAuth izin ekranını yapılandırın.
• Google Chat API'yi etkinleştirin.

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, Chat uygulamalarıyla etkileşim kurmak için bu bilgileri aşağıdaki şekillerde görür veya kullanır:

• Chat uygulamasından @bahsederek uygulamayı bir alana ekleyin veya uygulamaya mesaj gönderin.
• Chat uygulamasıyla doğrudan mesajları 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.

Bir 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 grafik resmine (PNG veya JPEG) yönlendiren bir HTTPS URL'si. Önerilen boyut 256 x 256 piksel veya daha fazladı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, bu bilgileri Chat API'deki yapılandırma ayarlarında belirtirsiniz.

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

Google Cloud Console'da, Chat uygulamanızla ilgili ayrıntıları yapılandırabilirsiniz. Bu ayrıntılar, görünen ad, avatar ve açıklama dahil olmak üzere Chat'teki kullanıcılara gösterilir. Bu ayrıntılar yalnızca Chat'te görünür. Chat uygulamanızı Marketplace'te yayınlamak için Chat uygulamanızın Marketplace girişinde gösterilen ayrıntıları da belirtmeniz gerekir.

Chat uygulaması ayrıntılarınızı aldıktan sonra Cloud projenizi açın ve 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ırma 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 açık konuma getirin ve aşağıdakileri tamamlayın:

   1. Chat uygulamanızın yüklenip kullanılabilmesi için İşlevsellik bölümünde Alanlara ve grup görüşmelerine katılma'yı seçin.

      Varsayılan olarak kullanıcılar, kullanıcı ile Chat uygulaması arasında özel bir alanda Chat uygulamasını yükleyip bu uygulamayla mesajlaşabilir. Kullanıcılar, birden fazla kişinin bulunduğu alanlara Chat uygulamasını ekleyip bu uygulamayla etkileşimde de bulunabilir.

   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 sağlayın.
      • Google Apps Komut Dosyası projesi kullanmak için Apps Komut Dosyası'nı seçin ve proje için bir dağıtım kimliği girin.
      Uyarı: Apps Komut Dosyası dağıtım kimliği zaten doluysa Cloud projesi mevcut bir Google Workspace eklentisine bağlıdır. Chat API'sinde dağıtım kimliğini güncellerseniz dağıtım kimliği eklentiniz için güncellenir ve Google Workspace Marketplace'teki girişinizi etkileyebilir. Eklenti yapılandırmanızı incelemek için Google Workspace Marketplace belgelerindeki
      Google Workspace Marketplace SDK'sında uygulamanızı yapılandırma başlıklı makaleyi inceleyin.

   3. İsteğe bağlı: Etkinlik nesnelerini birden fazla uç noktaya veya işleve almak için Bağlantı ayarları > Tetikleyiciler'e gidin ve aşağıdaki sohbet tetikleyicileri için geri çağırma işlevlerini sağlayın veya güncelleyin:

      Not: Apps Komut Dosyası'nda tetikleyicileri güncellemezseniz bu bölümde doldurulan ilgili geri çağırma işlevlerini (ör. onMessage, onAddedToSpace ve onRemovedFromSpace) kullanmanız gerekir.
      • Alana eklendi: Bir kullanıcı, Chat uygulamasını grup görüşmesine veya alana ekler ya da bire bir mesajlar için Chat uygulamasını yükler.
      • Mesaj: Bir kullanıcı, Chat uygulamasına mesaj gönderir. Örneğin, Chat uygulamasına doğrudan mesaj gönderir veya birden fazla kişinin bulunduğu bir alanda Chat uygulamasından @bahseder.
      • Alandan kaldırıldı: Bir kullanıcı, Chat uygulamasını alandan kaldırır veya uygulamanın yüklemesini kaldırır.
      • Uygulama komutu: Kullanıcı, Chat uygulamasında hızlı komut veya eğik çizgi komutu kullanır.

   4. İsteğe bağlı: Hızlı komutlar, eğik çizgi komutları veya bağlantı önizlemeleri gibi diğer etkileşimli özellikleri ekleyin.

   5. Görünürlük bölümünde, Google Workspace Marketplace'te yayınlamadan önce Chat uygulamasını yükleyip test edebilmeniz için e-posta adresinizi belirtin. Google Workspace kuruluşunuzdan en fazla beş kişi veya bir ya da daha fazla Google Grubu belirtebilirsiniz.

4. İsteğe bağlı: Google Cloud Logging'i kullanmak için Günlükler bölümünde Günlük hatalarını Logging'e onay kutusunu işaretleyin. Daha fazla bilgi için Chat API dokümanlarındaki Chat uygulamaları için sorgu hatası günlükleri başlıklı makaleyi inceleyin.

5. Kaydet'i tıklayın.

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

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 şartları göz önünde bulundurun:

• Hem bireyler hem de Google Workspace yöneticileri, eklentinizi Marketplace'ten yükleyebilmelidir. Bu yükleme ayarlarını Google Workspace Marketplace SDK'sında yapılandırabilirsiniz.
• 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 eklentiler için 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üncellenen Chat uygulaması, mevcut tüm kullanıcılar tarafından kullanılabilir. Marketplace girişinizi güncellemek için değişiklikleri göndermeden önce taslak oluşturabilirsiniz.

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

  • Eklenti yapılandırmanızın geri kalanı için kullandığınız Apps Komut Dosyası dağıtım kimliğini kullanmanız gerekir.
  • Chat'te test dağıtımlarını yüklemek için Apps Komut Dosyası Düzenleyicisi'ni kullanamazsınız. Bunun yerine, doğrudan Chat kullanıcı arayüzünden yüklemeniz gerekir.

• Eklentinizi bir HTTP hizmeti kullanarak oluşturduysanız Google Workspace eklentileri API'si ile oluşturduğunuz manifest ve dağıtımlarda Chat uygulaması yapılandırma ayrıntılarını atlayı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.

İlgili konular

• Chat API'ye erişimi yönetmek için Google Chat API belgelerindeki Google Chat API'yi yapılandırma başlıklı makaleyi inceleyin.
• Google Chat uygulamaları için etkileşimli özellikleri test etme