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

Bu sayfada, Google Chat uygulamasını Google Chat'in dışındaki bir hizmete veya araca nasıl bağlayacağınız açıklanmaktadır. Chat uygulamaları kendi başlarına güçlü olsa da genellikle diğer sistemlerle uyumlu şekilde çalışır ve hesapları bağlamak, veri erişimini yetkilendirmek, ek veriler görüntülemek veya kullanıcı tercihlerini yapılandırmak için tamamlayıcı uygulamalar gerektirir.

Bir kullanıcıdan Chat uygulamasının yapılandırılmasını isteme

Bir isteğin tamamlanması, doğrudan Chat uygulamasında tamamlayılamayan ek yapılandırma gerektiriyorsa kullanıcıya normal bir yanıtın parçası olarak bir yapılandırma URL'si döndürün veya aşağıdaki biçimde bunu gizli olarak sunun:

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

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

Yapılandırma isteğini tamamlayın

Chat uygulamanızın aldığı her MESSAGE etkileşim etkinliği de bir configCompleteRedirectUrl parametresi içerir. Bu URL, işlemin tamamlanmasında kullanılacak yapılandırma URL'nizde kodlanmalıdır. Bu URL'ye yönlendirme, Google Chat'e yapılandırma isteğinin yerine getirildiğini belirtir.

Chat uygulamanız başladığında, akış alınan mesaja göre değişir. Chat uygulaması, @app help gibi bir mesaja ek yapılandırma gerekmeden bir mesajla yanıt vermelidir.

Kullanıcı, orijinal mesajda sağlanan configCompleteRedirectUrl sayfasına başarıyla yönlendirildiğinde Google Chat aşağıdaki adımları gerçekleştirir:

  1. Görevi başlatan kullanıcıya gösterilen istemi silin.
  2. Orijinal mesajı herkese açık hâle getirerek alanın diğer üyelerinin görmesini sağlayabilirsiniz.
  3. Orijinal mesajı aynı Chat uygulamasına ikinci kez gönderin.

Bir configCompleteRedirectUrl ziyaret edilmesi yalnızca tek bir kullanıcı mesajını etkiler. Bir kullanıcı bir Chat uygulamasına birden fazla kez mesaj göndermeye çalıştıysa ve bunun sonucunda birden fazla istem aldıysa belirli bir istemi tıklayıp kimlik doğrulama ve yapılandırma işlemini tamamlamak yalnızca söz konusu mesajı etkiler. Diğer mesajlar değişmez.

Bir MESSAGE etkileşim etkinliği bu şekilde yeniden gönderildiğinde orijinal etkinlikle aynı olmalıdır ancak MESSAGE etkileşim etkinliklerinin farklılık gösterebileceği bazı durumlar vardır. Örneğin, bir mesajda hem Chat uygulaması A hem de Chat uygulaması B'den bahsedildiğinde Chat uygulaması A, Chat uygulaması B ile kimlik doğrulaması yapmadan önce normal bir mesajla yanıt verirse kullanıcı mesajı düzenleyebilir. Bu durumda, kullanıcı kimlik doğrulama ve yapılandırmayı tamamladıktan sonra Chat uygulaması B, düzenlenmiş mesaj metnini alır.

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

Bir API için OAuth yetkilendirmesi istemek gibi bazı durumlarda, uygulamanızın kullanıcı kimliğini korurken Chat dışındaki bir URL'ye bağlanması gerekir. Bu durumlarda kullanıcıyı tanımlamanın en iyi yolu Google ile Oturum Açma ile hedef uygulamayı korumaktır.

Kullanıcı kimliğini almak için oturum açma sırasında verilen kimlik jetonunu kullanın. sub hak talebi, kullanıcının benzersiz kimliğini içerir ve Google Chat'teki kullanıcı kimliğiyle ilişkilendirilebilir.

İki kimlik tam olarak aynı olmasa da zorlanabilir. sub hak talebinin değerini Google Chat users/{user} olarak elde etmek için değerin başına users/ ekleyin. Örneğin, 123 hak talebi değeri, Chat uygulamanıza gönderilen mesajlardaki users/123 kullanıcı adına eşdeğerdir.