Chat uygulamaları ve Google Chat API isteklerinin kimliğini doğrulama ve yetkilendirme

Kimlik doğrulama ve yetkilendirme, sırasıyla kimliği ve kaynaklara erişimi doğrulamak için kullanılan mekanizmalardır. Bu belgede, Chat uygulamaları ve Chat API istekleri için kimlik doğrulama ve yetkilendirme işlemlerinin nasıl çalıştığı açıklanmaktadır.

İşleme genel bakış

Aşağıdaki şemada, Google Chat'teki kimlik doğrulama ve yetkilendirme ile ilgili üst düzey adımlar gösterilmektedir:

Google Chat kimlik doğrulaması ve yetkilendirmesi için üst düzey adımlar
1. şekil. Google Chat kimlik doğrulama ve yetkilendirme ile ilgili üst düzey adımlar.

  1. Google Cloud projesi yapılandırın, Chat API'yi etkinleştirin ve Chat uygulamanızı yapılandırın: Geliştirme sırasında bir Google Cloud projesi oluşturursunuz. Google Cloud projesinde Chat API'yi etkinleştirir, Chat uygulamanızı yapılandırır ve kimlik doğrulamayı ayarlarsınız. Daha fazla bilgi için Google Workspace'te geliştirme ve Chat uygulaması oluşturma başlıklı makaleleri inceleyin.

  2. Chat API'yi çağırma: Uygulamanız Chat API'yi çağırdığında kimlik doğrulama kimlik bilgilerini Chat API'ye gönderir. Uygulamanız bir hizmet hesabıyla kimlik doğrulaması yapıyorsa kimlik bilgileri uygulamanızın koduyla birlikte gönderilir. Uygulamanızın, henüz verilmemiş bir kullanıcı kimlik doğrulaması kullanılarak Chat API'nin çağrılması gerekiyorsa kullanıcıdan oturum açması istenir.

  3. Kaynak iste: Uygulamanız, kimlik doğrulamayı ayarlarken belirttiğiniz kapsamlarla erişim ister.

  4. İzin isteyin: Uygulamanız kullanıcı olarak kimlik doğrulaması yapıyorsa Google, kullanıcının uygulamanıza istenen verilere erişim izni verip vermeyeceğine karar verebilmesi için bir OAuth izin ekranı gösterir. Hizmet hesabıyla kimlik doğrulama için kullanıcı izni gerekmez.

  5. Kaynaklar için onaylanmış istek gönderme: Kullanıcı yetkilendirme kapsamlarını kabul ederse uygulamanız kimlik bilgilerini ve kullanıcı tarafından onaylanmış kapsamları bir istekte birleştirir. Erişim jetonu almak için istek, Google yetkilendirme sunucusuna gönderilir.

  6. Google, bir erişim jetonu döndürür: Erişim jetonu, verilen kapsamların listesini içerir. Döndürülen kapsam listesi, istenen kapsam listesinden daha kısıtlayıcıysa uygulamanız, jetonla sınırlanan tüm özellikleri devre dışı bırakır.

  7. İstenen kaynaklara erişim: Uygulamanız, Chat API'yi çağırmak ve Chat API kaynaklarına erişmek için Google'dan alınan erişim jetonunu kullanır.

  8. Yenileme jetonu alma (isteğe bağlı): Uygulamanızın Google Chat API'ye tek bir erişim jetonunun kullanım süresinden daha uzun süre erişmesi gerekiyorsa yenileme jetonu alabilir. Daha fazla bilgi için Google API'lerine erişmek için OAuth 2.0'ı kullanma başlıklı makaleyi inceleyin.

  9. Daha fazla kaynak isteğinde bulunma: Uygulamanızın daha fazla erişime ihtiyacı varsa kullanıcıdan yeni kapsamlar vermesini ister. Bu da erişim jetonu almak için yeni bir isteğe yol açar (3-6. adımlar).

Sohbet uygulamaları ne zaman kimlik doğrulama gerektirir?

Sohbet uygulamaları, kullanıcı etkileşimine yanıt olarak veya eşzamansız olarak mesaj gönderebilir. Ayrıca, kullanıcı adına görevleri tamamlayabilir. Örneğin, Chat alanı oluşturabilir veya Chat alanındaki kişilerin listesini alabilir.

Chat uygulamaları, yanıt işleme sırasında Chat API'yi veya başka bir Google API'sini çağırmadığı sürece kullanıcı etkileşimine yanıt vermek için kimlik doğrulama gerektirmez.

Chat uygulamaları, eşzamansız mesaj göndermek veya kullanıcı adına görev gerçekleştirmek için Chat API'ye RESTful istekler gönderir. Bu istekler için kimlik doğrulama ve yetkilendirme gerekir.

Kullanıcı etkileşimlerine verilen yanıtlarda kimlik doğrulaması gerekmez.

Google Chat uygulamalarının, etkileşim etkinliklerini almak ve bunlara eşzamanlı olarak yanıt vermek için kullanıcı veya Chat uygulaması olarak kimlik doğrulaması yapması gerekmez.

Google Chat uygulamaları, bir kullanıcı etkileşimde bulunduğunda veya bir Chat uygulamasını çağırdığında aşağıdaki etkileşim etkinliklerini alır:

  • Kullanıcı, bir Chat uygulamasına mesaj gönderir.
  • Kullanıcı, Chat uygulamasından @bahseder.
  • Kullanıcı, Chat uygulamasının komutlarından birini çağırır.

Aşağıdaki şemada, bir Sohbet kullanıcısı ile Sohbet uygulaması arasındaki istek-yanıt sırası gösterilmektedir:

Chat uygulaması etkileşim etkinlikleri için yetkilendirme gerekmez
Şekil 2. Chat uygulaması etkileşim etkinlikleri için kimlik doğrulama gerekmez.

  1. Kullanıcı, Google Chat'teki Chat uygulamasına mesaj gönderir.
  2. Google Chat, mesajı uygulamaya yönlendirir.
  3. Uygulama, mesajı alır, işler ve Google Chat'e bir yanıt döndürür.
  4. Google Chat, kullanıcı veya bir alan için yanıtı oluşturur.

Bu sıra, her Chat uygulaması etkileşimi etkinliği için tekrarlanır.

Asenkron mesajlar kimlik doğrulama gerektirir

Asenkron mesajlar, bir Chat uygulaması Chat API'ye kimlik doğrulama ve yetkilendirme gerektiren bir istekte bulunduğunda gerçekleşir.

Chat uygulamaları, Chat API'yi çağırarak Google Chat'e mesaj gönderebilir veya kullanıcı adına görevleri tamamlayıp verilere erişebilir. Örneğin, bir sunucu kesintisi algılandıktan sonra Chat uygulaması, Chat API'yi çağırarak şunları yapabilir:

  • Kesintiyi araştırıp düzeltmeye yönelik bir Chat alanı oluşturun.
  • Chat alanına kullanıcı ekleme
  • Kesintiyle ilgili ayrıntıları vermek için Chat alanına mesaj gönderin.

Aşağıdaki şemada, bir Chat uygulaması ile bir Chat alanı arasındaki asenkron mesaj dizisi gösterilmektedir:

Asenkron mesajlar için kimlik doğrulama gerekir
3.şekil Asenkron mesajlar kimlik doğrulama gerektirir.

  1. Bir sohbet uygulaması, spaces.messages.create yöntemini kullanarak Chat API'yi çağırarak mesaj oluşturur ve HTTP isteğine kullanıcı kimlik bilgilerini ekler.
  2. Google Chat, Chat uygulamasının kimliğini hizmet hesabı veya kullanıcı kimlik bilgileriyle doğrular.
  3. Google Chat, uygulamanın mesajını belirtilen bir Chat alanında oluşturur.

Chat API kapsamları

Kullanıcılara ve uygulama inceleyicilerine hangi bilgilerin gösterileceğini tanımlamak için OAuth izin ekranını yapılandırın ve kapsamları seçin. Ayrıca, uygulamanızı daha sonra yayınlayabilmek için kaydedin.

Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını belirleyip beyan etmeniz gerekir. Yetkilendirme kapsamı, Google Workspace uygulama adını, eriştiği veri türünü ve erişim düzeyini içeren bir OAuth 2.0 URI dizesidir.

Hassas olmayan kapsamlar

Kapsam kodu Açıklama
https://www.googleapis.com/auth/chat.bot

Lets Chat uygulamalarının sohbetleri görüntülemesine ve mesaj göndermesine izin verilir.

Bu kapsam yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde temsil ile kimlik doğrulama yapamazsınız.

Hassas kapsamlar

Kapsam kodu Açıklama
https://www.googleapis.com/auth/chat.spaces Chat'te görüşmeler ve alanlar oluşturup meta verileri (geçmiş ayarları ve erişim ayarları dahil) görme veya düzenleme
https://www.googleapis.com/auth/chat.spaces.create Chat'te yeni görüşmeler oluşturma
https://www.googleapis.com/auth/chat.spaces.readonly Chat'te sohbet ve alanları görüntüleme
https://www.googleapis.com/auth/chat.memberships Chat'teki görüşmelerde üyeleri görüntüleme, ekleme, güncelleme veya kaldırma.
https://www.googleapis.com/auth/chat.memberships.app Kendisini Google Chat'teki görüşmelere ekleme ve görüşmelerden kaldırma
https://www.googleapis.com/auth/chat.memberships.readonly Chat görüşmelerindeki üyeleri görüntüleme
https://www.googleapis.com/auth/chat.messages.create Chat'te mesaj oluşturma ve gönderme
https://www.googleapis.com/auth/chat.messages.reactions Chat'te mesajlara tepki ekleme, tepkileri görüntüleme ve silme
https://www.googleapis.com/auth/chat.messages.reactions.create Chat'te mesajlara tepki ekleme
https://www.googleapis.com/auth/chat.messages.reactions.readonly Chat'te bir mesaja verilen tepkileri görüntüleme
https://www.googleapis.com/auth/chat.users.readstate Chat görüşmelerinin son okunma zamanını görüntüleme ve değiştirme
https://www.googleapis.com/auth/chat.users.readstate.readonly Chat görüşmelerinin son okunma zamanını görüntüleme
https://www.googleapis.com/auth/chat.admin.spaces.readonly Chat'te yöneticinin alanına ait sohbet ve alanları görüntüleme
https://www.googleapis.com/auth/chat.admin.spaces Chat'te yöneticinin alanına ait sohbet ve alanları görüntüleme veya düzenleme
https://www.googleapis.com/auth/chat.admin.memberships.readonly Chat'te yöneticinin alanına ait görüşmelerdeki üyeleri ve yöneticileri görüntüleme
https://www.googleapis.com/auth/chat.admin.memberships Chat'te yöneticinin alanına ait görüşmelerdeki üyeleri ve yöneticileri görüntüleme, ekleme, güncelleme ve kaldırma
https://www.googleapis.com/auth/chat.app.spaces

Chat'te görüşmeler ve alanlar oluşturup meta verileri (geçmiş ayarları ve erişim ayarları dahil) görme ya da güncelleme Yönetici onayı gerektirir.

Bu kapsam yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde temsil ile kimlik doğrulama yapamazsınız.

https://www.googleapis.com/auth/chat.app.spaces.create

Chat'te yeni görüşmeler ve alanlar oluşturma Yönetici onayı gerektirir.

Bu kapsam yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde temsil ile kimlik doğrulama yapamazsınız.

https://www.googleapis.com/auth/chat.app.memberships

Chat'teki görüşmeler ve alanlarda üyeleri görme, ekleme, güncelleme ve kaldırma Yönetici onayı gerektirir.

Bu kapsam yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde temsil ile kimlik doğrulama yapamazsınız.

https://www.googleapis.com/auth/chat.customemojis Chat'te özel emojileri görüntüleme, oluşturma ve silme
https://www.googleapis.com/auth/chat.customemojis.readonly Chat'te özel emojileri görüntüleme
https://www.googleapis.com/auth/chat.users.spacesettings Chat kullanıcı alanı ayarlarını görüntüleme ve güncelleme

Kısıtlanmış kapsamlar

Kapsam kodu Açıklama
https://www.googleapis.com/auth/chat.delete Chat'te görüşmeleri ve alanları silme, ilişkili dosyalara erişimi kaldırma
https://www.googleapis.com/auth/chat.import Alanları, mesajları ve üyelikleri Chat'e aktarma. Daha fazla bilgi için Chat uygulamalarını veri içe aktarmak üzere yetkilendirme başlıklı makaleyi inceleyin.
https://www.googleapis.com/auth/chat.messages Mesajları görüntüleme, oluşturma, gönderme, güncelleme ve silme; mesajlara tepki ekleme, verilen tepkileri görüntüleme ve silme.
https://www.googleapis.com/auth/chat.messages.readonly Chat'te mesajları ve tepkileri görüntüleme
https://www.googleapis.com/auth/chat.admin.delete Yöneticinin alanına ait görüşmeleri ve alanları silme, Chat'teki ilişkili dosyalara erişimi kaldırma.
https://www.googleapis.com/auth/chat.app.delete

Chat'te görüşmeleri ve alanları silme ve ilişkili dosyalara erişimi kaldırma Yönetici onayı gerektirir.

Bu kapsam yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde temsil ile kimlik doğrulama yapamazsınız.

Önceki tablolardaki kapsamlar, aşağıdaki tanımlara göre hassasiyetlerini gösterir:

Uygulamanızın başka Google API'lerine erişmesi gerekiyorsa bu kapsamları da ekleyebilirsiniz. Google API kapsamları hakkında daha fazla bilgi için Google API'lerine Erişmek İçin OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.

Google Workspace API'lerinin kapsamları hakkında daha fazla bilgi edinmek için OAuth kullanıcı rızası ekranını yapılandırma ve kapsamları seçme başlıklı makaleyi inceleyin.

Gerekli kimlik doğrulama türleri

Chat uygulamaları, Chat API ile iki şekilde kimlik doğrulama ve yetkilendirme yapabilir:

Kullanıcı kimlik doğrulaması
Kullanıcı kimlik doğrulaması, Chat uygulamalarının kullanıcı verilerine erişmesine ve kullanıcı adına işlemler yapmasına olanak tanır. OAuth kapsamları, yetkili verileri ve işlemleri belirtir. Chat uygulaması yönetici tarafından yüklenmediyse veya alan adı genelinde yetki verilmediyse Chat uygulaması, bir kullanıcının adına ilk kez işlem yaptığında kullanıcının OAuth izin ekranını kullanarak Chat uygulamasına yetki vermesi gerekir.
Uygulama kimlik doğrulaması

Uygulama kimlik doğrulaması, bir Chat uygulamasının hizmet hesabı kimlik bilgilerini kullanmasına, verilere erişmesine ve işlemleri kendisi olarak tamamlamasına olanak tanır. Chat uygulaması, kaynaklara erişmek ve kaynaklarla çalışmak için kendi kimlik bilgilerini kullandığından son kullanıcıların Chat uygulamasının API çağrılarını onaylaması gerekmez ve OAuth izin ekranına uygulama yetkilendirmesini destekleyen OAuth yetkilendirme kapsamları ekleyemezsiniz.

Uygulama kimlik doğrulamasını destekleyen iki tür OAuth yetkilendirme kapsamı vardır:

  • https://www.googleapis.com/auth/chat.bot: Chat uygulamanız, bu yetkilendirme kapsamını destekleyen Google Chat API yöntemlerini çağırarak erişebildiği kaynakları (ör. son kullanıcıların Chat uygulamanızı eklediği alanlardaki mesajlar) oluşturabilir, güncelleyebilir, alabilir, listeleyebilir veya silebilir. Chat uygulamanız bu yetkilendirme kapsamını kendi kendine verebilir. Yönetici veya son kullanıcı yetkilendirmesi gerekmez.
  • https://www.googleapis.com/auth/chat.app.*: Bu kapsamların kullanılması için tek seferlik yönetici onayı gerekir. Yönetici onayı almak için Google Workspace Marketplace ile uyumlu bir OAuth istemcisi oluşturarak ve uygulamayı Google Workspace Marketplace SDK'sında yapılandırarak Chat uygulamasının hizmet hesabını yönetici onayı almaya hazırlarsınız. Bu kapsamlar, Chat uygulamanızın belirli Google Chat API yöntemlerini çağırmasına olanak tanır. Örneğin, chat.app.spaces.create uygulamaların Chat alanları oluşturmasına izin verir.

Bir yöntem hem kullanıcı hem de uygulama kimlik doğrulamasını destekliyorsa Chat API, kullandığınız kimlik doğrulama türüne göre farklı sonuçlar döndürür:

  • Uygulama kimlik doğrulamasıyla yöntemler yalnızca Sohbet uygulamasının erişebileceği kaynakları döndürür.
  • Kullanıcı kimlik doğrulamasıyla yöntemler yalnızca kullanıcının erişebileceği kaynakları döndürür.

Örneğin, uygulama yetkilendirmesiyle spaces.list() yöntemini çağırmak, Chat uygulamasının üyesi olduğu alanların listesini döndürür. Kullanıcı yetkilendirmesiyle spaces.list() çağrıldığında kullanıcının üyesi olduğu alanların listesi döndürülür. Uygulamada, Chat uygulamanızın tasarımına ve özelliklerine bağlı olarak Chat API'yi çağırırken her iki kimlik doğrulama türünü de kullanabilirsiniz.

Zaman uyumsuz Chat API çağrıları için

Aşağıdaki tabloda Chat API yöntemleri ve desteklenen yetkilendirme kapsamları listelenmektedir:

Yöntem Kullanıcı kimlik doğrulaması desteklenir. Uygulama kimlik doğrulaması desteklenir. Desteklenen yetkilendirme kapsamları
Alanlar  
Alan oluşturma Kullanıcı kimlik doğrulaması ile:
  • chat.spaces.create
  • chat.spaces
  • chat.import
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.spaces.create
  • chat.app.spaces
Alan oluşturma Kullanıcı kimlik doğrulaması ile:
  • chat.spaces.create
  • chat.spaces
Alan edinme Kullanıcı kimlik doğrulaması ile:
  • chat.spaces.readonly
  • chat.spaces
Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması ile:
  • chat.admin.spaces.readonly
Uygulama kimlik doğrulaması ile:
  • chat.bot
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.spaces
Alanları listeleme Kullanıcı kimlik doğrulaması ile:
  • chat.spaces.readonly
  • chat.spaces
Uygulama kimlik doğrulaması ile:
  • chat.bot
Alanlarda arama yapma Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması ile:
  • chat.admin.spaces.readonly
Alan güncelleme Kullanıcı kimlik doğrulaması ile:
  • chat.spaces
  • chat.import
Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması ile:
  • chat.admin.spaces
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.spaces
Alan silme Kullanıcı kimlik doğrulaması ile:
  • chat.delete
  • chat.import
Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması ile:
  • chat.admin.delete
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.delete
Alan için içe aktarma işlemini tamamlama Kullanıcı kimlik doğrulaması ile:
  • chat.import
Doğrudan mesaj bulma Kullanıcı kimlik doğrulaması ile:
  • chat.spaces.readonly
  • chat.spaces
Uygulama kimlik doğrulaması ile:
  • chat.bot
Üyeler  
Üye oluşturma Kullanıcı kimlik doğrulaması ile:
  • chat.memberships
  • chat.memberships.app
  • chat.import
Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması ile:
  • chat.admin.memberships
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.memberships
Üye edinme Kullanıcı kimlik doğrulaması ile:
  • chat.memberships.readonly
  • chat.memberships
Uygulama kimlik doğrulaması ile:
  • chat.bot
Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması ile:
  • chat.admin.memberships.readonly
Liste üyeleri Kullanıcı kimlik doğrulaması ile:
  • chat.memberships.readonly
  • chat.memberships
  • chat.import
Uygulama kimlik doğrulaması ile:
  • chat.bot
Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması ile:
  • chat.admin.memberships.readonly
Üye silme Kullanıcı kimlik doğrulaması ile:
  • chat.memberships
  • chat.memberships.app
  • chat.import
Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması ile:
  • chat.admin.memberships
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.memberships
Üyeyi güncelleme Kullanıcı kimlik doğrulaması ile:
  • chat.memberships
  • chat.import
Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması ile:
  • chat.admin.memberships
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.memberships
Mesajlar  
Mesaj oluşturma Kullanıcı kimlik doğrulaması ile:
  • chat.messages.create
  • chat.messages
  • chat.import
Uygulama kimlik doğrulaması ile:
  • chat.bot
Mesaj alma Kullanıcı kimlik doğrulaması ile:
  • chat.messages.readonly
  • chat.messages
Uygulama kimlik doğrulaması ile:
  • chat.bot
Listeleme mesajları Kullanıcı kimlik doğrulaması ile:
  • chat.messages.readonly
  • chat.messages
  • chat.import
Mesaj güncelleme Kullanıcı kimlik doğrulaması ile:
  • chat.messages
  • chat.import
Uygulama kimlik doğrulaması ile:
  • chat.bot
İleti silme Kullanıcı kimlik doğrulaması ile:
  • chat.messages
  • chat.import
Uygulama kimlik doğrulaması ile:
  • chat.bot
Tepkiler  
Tepki oluşturma Kullanıcı kimlik doğrulaması ile:
  • chat.messages.reactions.create
  • chat.messages.reactions
  • chat.messages
  • chat.import
Tepkileri listeleme Kullanıcı kimlik doğrulaması ile:
  • chat.messages.reactions.readonly
  • chat.messages.reactions
  • chat.messages.readonly
  • chat.messages
Tepki silme Kullanıcı kimlik doğrulaması ile:
  • chat.messages.reactions
  • chat.messages
  • chat.import
Özel emoji  
Özel emoji oluşturma Kullanıcı kimlik doğrulaması ile:
  • chat.customemojis
Özel bir emojiyi silme Kullanıcı kimlik doğrulaması ile:
  • chat.customemojis
Özel emoji edinme Kullanıcı kimlik doğrulaması ile:
  • chat.customemojis
  • chat.customemojis.readonly
Özel emojileri listeleme Kullanıcı kimlik doğrulaması ile:
  • chat.customemojis
  • chat.customemojis.readonly
Medya ve ekler  
Medya dosyalarını ek olarak yükleme Kullanıcı kimlik doğrulaması ile:
  • chat.messages.create
  • chat.messages
  • chat.import
Medya indirme Kullanıcı kimlik doğrulaması ile:
  • chat.messages.readonly
  • chat.messages
Uygulama kimlik doğrulaması ile:
  • chat.bot
İleti eki alma Uygulama kimlik doğrulaması ile:
  • chat.bot
Kullanıcı okuma durumları
Kullanıcının alan okuma durumunu alma Kullanıcı kimlik doğrulaması ile:
  • chat.users.readstate
  • chat.users.readstate.readonly
Kullanıcının alan okuma durumunu güncelleme Kullanıcı kimlik doğrulaması ile:
  • chat.users.readstate
Bir kullanıcının ileti dizisi okuma durumunu alma Kullanıcı kimlik doğrulaması ile:
  • chat.users.readstate
  • chat.users.readstate.readonly
Kullanıcı alanı ayarları
Kullanıcının alan bildirim ayarını alma Kullanıcı kimlik doğrulaması ile:
  • chat.users.spacesettings
Kullanıcının alan bildirim ayarını güncelleme Kullanıcı kimlik doğrulaması ile:
  • chat.users.spacesettings
Alan etkinlikleri
Alan etkinliklerini alma Kullanıcı kimlik doğrulaması ile, etkinlik türüne göre bir kapsam kullanmanız gerekir:
  • Mesajlarla ilgili etkinlikler için:
    • chat.messages
    • chat.messages.readonly
  • Tepkilerle ilgili etkinlikler için:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • Üyeliklerle ilgili etkinlikler için:
    • chat.memberships
    • chat.memberships.readonly
  • Alanla ilgili etkinlikler için:
    • chat.spaces
    • chat.spaces.readonly
Alan etkinliklerini listeleme Kullanıcı kimlik doğrulaması ile, istekte yer alan her etkinlik türü için bir kapsam kullanmanız gerekir:
  • Mesajlarla ilgili etkinlikler için:
    • chat.messages
    • chat.messages.readonly
  • Tepkilerle ilgili etkinlikler için:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • Üyeliklerle ilgili etkinlikler için:
    • chat.memberships
    • chat.memberships.readonly
  • Alanla ilgili etkinlikler için:
    • chat.spaces
    • chat.spaces.readonly

Chat uygulaması etkileşim etkinlikleri için

Aşağıdaki tabloda, kullanıcıların Chat uygulamalarıyla etkileşim kurmak için kullandığı yaygın yöntemler ve kimlik doğrulamanın gerekli olup olmadığı ya da desteklenip desteklenmediği listelenmiştir:

Senaryo Kimlik doğrulama gerekmez Kullanıcı kimlik doğrulaması desteklenir. Uygulama kimlik doğrulaması desteklenir.
Şu kişilerden mesaj al:
Chat uygulaması etkileşim etkinlikleri
Apps Komut Dosyası geri çağırmaları
Google Cloud Pub/Sub
İletileri yanıtlama:
Eşzamanlı olarak, Chat uygulaması etkileşim etkinliği kullanılarak
Apps Komut Dosyası geri çağırma dönüş değeri kullanılarak senkron olarak
Yeni mesaj gönderme:
Gelen webhook'larla