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

Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programının bir parçası olarak kullanılabilir.

Bu sayfada, bir 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ştirmeniz ve yapılandırmanız gerekir. Chat API yapılandırma ayarlarında Chat uygulamasıyla ilgili tüm ayrıntıları (ad, avatar, dağıtım ve kullanmak istediğiniz etkileşimli özellikler dahil) belirtirsiniz.

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ılı bilgi için Sınırlamalar ve bilinen sorunlar başlıklı makaleyi inceleyin.

Ön koşullar

HTTP

• 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ın hizmet mimarisini barındıran bir HTTP uç noktası.

Apps Komut Dosyası

• 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.
• Bağımsız bir Apps Komut Dosyası projesi oluşturun ve Gelişmiş Chat Hizmeti'ni etkinleştirin.
• addons.chat nesnesini ve gerekli kapsamları (oauthScopes) veya HTTPS URL'si öneklerini (urlFetchWhitelist) ekleyerek manifest dosyasında Chat'i yapılandırın.

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

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şimde bulunmak için bu bilgileri aşağıdaki şekillerde görür veya kullanır:

• Bir alana eklemek veya mesaj göndermek için Chat uygulamasından @bahsedin.
• Chat uygulamasında doğrudan mesaj bulup başlatın. Uygulamalar menüsünde, doğrudan mesajlar Chat uygulamasının adı ve avatarı olarak gösterilir.
• Kullanıcılar, yazma çubuğundan Chat uygulamalarına göz atarak 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 görüntüsüne (PNG veya JPEG) işaret eden bir HTTPS URL'si. Önerilen boyut 256 x 256 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, bu bilgileri Chat API'deki yapılandırma ayarlarında belirtirsiniz.

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

Chat uygulamanızın ayrıntılarını öğrendikten sonra Cloud projenizi açın ve Chat API'yi yapılandırın:

1. Google Cloud konsolunda 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 açık konuma getirin ve aşağıdaki işlemleri tamamlayın:

   1. İşlevsellik bölümünde, Chat uygulamanızı yüklenebilir ve kullanılabilir hale getirmek için bir veya daha fazla onay kutusunu işaretleyin:

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

      • Alanlara ve grup görüşmelerine katılma: Kullanıcılar, birden fazla kişinin bulunduğu alanlarda Chat uygulamasını ekleyebilir ve uygulamayla etkileşimde bulunabilir.

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

      • HTTP hizmeti kullanmak için HTTP uç nokta URL'si seçeneğini belirleyin ve bir URL girin.
      • Google Apps Komut Dosyası projesini kullanmak için Apps Komut Dosyası'nı seçin ve proje için dağıtım kimliği sağlayın.
      Uyarı: Halihazırda bir Apps Komut Dosyası dağıtım kimliği girilmişse Cloud projesi mevcut bir Google Workspace eklentisine bağlanır. Chat API'de dağıtım kimliğini güncellerseniz eklentinizin dağıtım kimliği güncellenir ve Google Workspace Marketplace'teki girişinizi etkileyebilir. Eklenti yapılandırmanızı incelemek için Google Workspace Marketplace dokümanlarındaki Uygulamanızı Google Workspace Marketplace SDK'sında yapılandırma bölümüne bakın.

   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 Chat tetikleyicileri için geri çağırma işlevlerini sağlayın veya güncelleyin:

      Not: Apps Komut Dosyası için tetikleyicileri güncellemezseniz bu bölümde doldurulan ilgili geri çağırma işlevlerini (onMessage, onAddToSpace ve onRemoveFromSpace gibi) kullanmanız gerekir.
      • Alana eklendi: Kullanıcı, Chat uygulamasını grup görüşmesine veya alana ekler ya da 1:1 mesajlar için Chat uygulamasını yükler.
      • Mesaj: 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 @bahsedilir.
      • Alandan kaldırıldı: Kullanıcı, Chat uygulamasını alandan veya alandan kaldırır.
      • Uygulama komutu: Kullanıcı, Chat uygulamasından hızlı bir 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. Google Workspace Marketplace'te yayınlamadan önce Chat uygulamasını yükleyip test edebilmek için Görünürlük bölümünde e-posta adresinizi belirtin. En fazla beş kişi veya Google Workspace kuruluşunuzdan 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, Hataları günlüğe kaydet onay kutusunu işaretleyin. Daha fazla bilgi için Chat API belgelerindeki 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 ayarı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ındaki 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ın kapsamını genişleten Google Workspace eklentilerinden farklı bir yapılandırma gerektirir. Eklentiniz diğer Google Workspace uygulamalarının kapsamını genişletiyorsa Chat uygulamasını yapılandırmak için aşağıdaki koşulları göz önünde bulundurun:

• Eklentinizi Marketplace'ten hem bireyler hem de Google Workspace yöneticileri yükleyebilmelidir. Bu yükleme ayarlarını Google Workspace Marketplace SDK'sında yapılandırırsınız.
• Chat uygulamaları, manifest'in 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 kaydetmenizin ardından, 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 bir 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üzenleyicisini kullanamazsınız. Bunun yerine, bu uygulamaları doğrudan Chat kullanıcı arayüzünden yüklemeniz gerekir.

• Eklentinizi bir HTTP hizmeti kullanarak oluşturduysanız manifestteki Chat uygulaması yapılandırma ayrıntılarını ve Google Workspace eklentileri API'sini kullanarak oluşturduğunuz dağıtımları 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 dokümanlarındaki Google Chat API'yi yapılandırma bölümüne bakın.
• Google Chat uygulamaları için etkileşimli özellikleri test etme
• Google Chat uygulamalarını yayınlama