Chat uygulamasını diğer hizmetlere ve araçlara bağlama

Bu sayfada, Google Chat uygulamasını bir hizmete nasıl bağlayacağınız açıklanmaktadır. Google Chat dışındaki bir araçta kullanılabilir. Chat uygulamaları kendi başlarına güçlüdür, genellikle diğer sistemlerle uyum içinde çalışır ve hesapları bağlamak, veri erişimini yetkilendirmek, görüntülemek için tamamlayıcı uygulamalar oluşturabilir veya kullanıcı tercihlerini yapılandırabilirsiniz.

Ön koşullar

Etkileşimli özellikler için etkinleştirilmiş bir Google Chat uygulaması. Bir aşağıdaki hızlı başlangıç kılavuzlarından birini kullanarak oluşturmak istediğiniz uygulama mimarisinde:

Bir kullanıcıdan Chat uygulama yapılandırması isteme

Bir isteği tamamlamak için çalıştırılamayan ek yapılandırma gerekiyorsa doğrudan Chat uygulamasında tamamladığınızda: normal bir yanıtın parçası olarak kullanıcıya yapılandırma URL'si göndermek veya özel olarak sunmak gönderin:

{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "CONFIGURATION_URL"
  }
}

Bu işlem, Google Chat'e kullanıcıya özel bir istem sunmasını söyler. CONFIGURATION_URL bir bağlantıdır ek kimlik doğrulama, yetkilendirme veya erişim için yapılandırma. REQUEST_CONFIG yanıtı, normal bir mesajı gönderebilirsiniz. Metinler, kartlar veya diğer özellikler yoksayılır.

Yapılandırma isteğini tamamlama

Hepsini MESSAGE etkileşim etkinliği alan bilgisi de dahil olmak üzere configCompleteRedirectUrl. Bu URL'yi işlem tamamlandığında kullanılacak yapılandırma URL'si. Bu sayfaya yönlendiriliyorsunuz URL, Google Chat'e yapılandırma isteğinin yerine getirildiğini bildirir.

Chat uygulamanız başladığında akış alınan belirli bir ileti. @app help gibi bir iletiye yanıt olarak, Chat uygulaması, mesaj olmadan yanıt vermelidir ek yapılandırma gerektirir.

Kullanıcı configCompleteRedirectUrl uygulamasına başarıyla yönlendirildiğinde Google Chat aşağıdaki adımları gerçekleştirir:

  1. Başlatan kullanıcıya gösterilen istemi silin.
  2. Orijinal iletiyi herkese açık olarak dönüştürerek diğer grup üyelerinin görmesini sağlayın ortaya çıkar.
  3. Orijinal mesajı aynı Chat uygulamasına gönder bir kez daha gönderin.

Bir configCompleteRedirectUrl adresini ziyaret etmek yalnızca tek bir kullanıcı mesajını etkiler. Kullanıcı bir Chat uygulamasına birden fazla mesaj göndermeyi denediyse ve sonuç olarak belirli bir web sayfasını tıklayarak kimlik doğrulama ve yapılandırma sürecini tamamlamak, karar vermelisiniz. Diğer mesajlar değişmez.

Bir MESSAGE etkileşim etkinliği bu şekilde yeniden gönderildiğinde aynı olmalıdır. ve ancak bazı durumlarda MESSAGE etkileşim etkinlikleri farklılık gösterebilir. Örneğin, bir mesajda her ikisinden de bahsedildiğinde Chat uygulaması A ve Chat uygulaması B, Chat uygulaması A ise kullanıcı mesajı düzenleyebilir Kullanıcı, kimlik doğrulaması yapmadan önce normal bir mesajla yanıt verir. Chat uygulaması B. Böyle durumlarda Chat uygulaması B, Kullanıcı kimlik doğrulama ve yapılandırmayı tamamlar.

Chat kullanıcısının kimliğini Chat dışında doğrulama

API için OAuth yetkilendirmesi isteme gibi bazı durumlarda, uygulamanızın kullanıcıyı korurken Chat dışındaki bir URL'ye yönlendirme kimliği. Bu durumlarda kullanıcıyı tanımlamanın en iyi yolu Google ile Oturum Açma sistemine sahip hedef uygulamayı kullanabilirsiniz.

Şunu kullanın: kimlik jetonu verilen kodu girmeniz gerekir. sub hak talebi, kullanıcının benzersiz kimliktir ve Google Chat'teki kullanıcı kimliğiyle ilişkilendirilebilir.

İki kimlik tam olarak aynı olmasa da zorunlu kılınabilir. Alıcı: Google Chat'teki sub hak talebinin değerini zorlayın users/{user}, başa ekle users/ ile değiştirin. Örneğin, 123 hak talebi değeri eşdeğerdir adresine gönderdiğiniz iletilerde users/123 kullanıcı adına Chat uygulaması.