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

Kimlik doğrulama ve yetkilendirme, sırasıyla kimliği doğrulamak ve kaynaklara erişmek için kullanılan mekanizmalardır. Bu dokümanda, kimlik doğrulama ve yetkilendirmenin Chat uygulamaları ve Chat API isteklerinde işleyiş şekli özetlenmiştir.

İşleme genel bakış

Aşağıdaki şemada, Google Chat için kimlik doğrulama ve yetkilendirmenin üst düzey adımları gösterilmektedir:

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

  1. Google Cloud projesi yapılandırma, Chat API'yi etkinleştirme ve Chat uygulamanızı yapılandırma: 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 uygulama geliştirme ve Chat uygulaması geliştirme makalelerine göz atın.

  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 kodunun bir parçası olarak gönderilir. Uygulamanız, henüz verilmemiş bir kullanıcı kimlik doğrulamasını kullanarak Chat API'yi çağırmayı gerektiriyorsa kullanıcıdan oturum açmasını ister.

  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ına izin verirse uygulamanız kimlik bilgilerini ve kullanıcı tarafından onaylanan kapsamları bir istek halinde paketler. 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 kapsamlardan 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 gelen erişim jetonunu kullanır.

  8. Yenileme jetonu alma (isteğe bağlı): Uygulamanızın, tek bir erişim jetonunun geçerlilik süresi bittikten sonra Google Chat API'ye 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: Uygulamanızın daha fazla erişime ihtiyacı varsa kullanıcıdan yeni kapsamlar vermesini ister. Bu da erişim jetonu almayla ilgili yeni bir istekle sonuçlanır (3-6. adımlar).

Sohbet uygulamaları kimlik doğrulama gerektirdiğinde

Chat uygulamaları, kullanıcı etkileşimine yanıt olarak veya eşzamansız olarak mesaj gönderebilir. Ayrıca, Chat alanı oluşturma veya Chat alanındaki kullanıcıların listesini alma gibi görevleri kullanıcı adına tamamlayabilirler.

Chat uygulamaları, bir yanıtı işlerken Chat API'yi veya başka bir Google API'yi ç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örevler gerçekleştirmek için Chat API'ye RESTful istekler gönderir. Bu istekler kimlik doğrulama ve yetkilendirme gerektirir.

Kullanıcı etkileşimlerine verilen yanıtlar için kimlik doğrulaması gerekmez

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

Google Chat uygulamaları, bir kullanıcı bir Chat uygulamasıyla etkileşim kurduğunda veya uygulamayı çağrdığında aşağıdakiler dahil olmak üzere etkileşim etkinlikleri alır:

  • Kullanıcı bir Chat uygulamasına mesaj gönderir.
  • Kullanıcı bir Chat uygulamasını @mention eder.
  • Kullanıcı, Chat uygulamasının eğik çizgi komutlarından birini çağırır.

Aşağıdaki şemada, Chat kullanıcısı ile Chat 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 kimlik doğrulama gerektirmez.

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

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

Eşzamansız iletiler için kimlik doğrulaması gerekir

Eşzamansız mesajlar, bir Chat uygulaması Chat API'ye istek gönderdiğinde ortaya çıkar. Bu istek için kimlik doğrulama ve yetkilendirme gerekir.

Chat uygulamaları, Chat API'yi çağırarak Google Chat'te mesaj yayınlayabilir, görevleri tamamlayabilir ve kullanıcı adına verilere erişebilir. Örneğin, bir Chat uygulaması sunucu kesintisi algıladıktan sonra Chat API'yi çağırarak şunları yapabilir:

  • Kesintiyi araştırmaya ve düzeltmeye özel bir Chat alanı oluşturun.
  • Chat alanına kullanıcı ekleyin.
  • Kesintiyle ilgili ayrıntıları paylaşmak için Chat alanında bir mesaj yayınlayın.

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

Eşzamansız mesajlar için kimlik doğrulaması gerekir
Şekil 3. Eşzamansız mesajlar için kimlik doğrulama gerekir.

  1. Bir Chat uygulamaları, spaces.messages.create yöntemini kullanarak Chat API'yi çağırarak bir 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ına yayınlar.

Chat API kapsamları

Kullanıcılara ve uygulama incelemecilerine hangi bilgilerin gösterileceğini tanımlamak ve daha sonra yayınlayabilmeniz için uygulamanızı kaydetmek için OAuth izin ekranını yapılandırın ve kapsamları seçin.

Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını tanımlamanız ve beyan etmeniz gerekir. Yetkilendirme kapsamı; Google Workspace uygulamasının adını, eriştiği verilerin 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

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

Bu kapsam yalnızca hizmet hesaplarıyla uygulama kimlik doğrulamasını destekler. Bu kapsamı kullanarak kullanıcı kimlik bilgileriyle veya alan genelinde yetki ile kimlik doğrulaması 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üleyin.
https://www.googleapis.com/auth/chat.memberships Chat'teki görüşmelerde üyeleri görüntüleme, ekleme, güncelleme ve 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 bir mesaja 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üleyebilir ve değiştirebilirsiniz.
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 sohbetleri 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 veya 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 yetkilendirme ile kimlik doğrulaması yapamazsınız.

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

Chat'te yeni görüşmeler ve alanlar oluşturabilirsiniz. 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 yetkilendirme ile kimlik doğrulaması yapamazsınız.

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

Chat'teki görüşmelerde ve alanlardan üyeleri görme, ekleme, güncelleme veya 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 yetkilendirme ile kimlik doğrulaması 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üleyip güncelleyebilirsiniz.

Alan kullanıcı ayarları API'lerine bakın: getSpaceNotificationSetting, updateSpaceNotificationSetting

Kısıtlanmış kapsamlar

Kapsam kodu Açıklama
https://www.googleapis.com/auth/chat.delete Chat'te görüşmeleri ve alanları silin ve ilişkili dosyalara erişimi kaldırın.
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 aktarması için 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üleyin.
https://www.googleapis.com/auth/chat.admin.delete Yöneticinin alanına ait görüşmeleri ve alanları silme ve Chat'te 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 yetkilendirme ile kimlik doğrulaması yapamazsınız.

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

Uygulamanız başka Google API'lerine erişim gerektiriyorsa bu kapsamları da ekleyebilirsiniz. Google API kapsamları hakkında daha fazla bilgi için Google API'lerine erişmek iç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 kimlik doğrulama ve yetkilendirmeyi iki şekilde yapabilir:

Kullanıcı kimlik doğrulaması
Kullanıcı kimlik doğrulaması, bir Chat uygulamasının kullanıcı verilerine erişip kullanıcı adına işlemleri tamamlamasına olanak tanır. OAuth kapsamları, yetkili verileri ve işlemleri belirtir. Chat uygulaması yönetici tarafından yüklenmemiş veya alan adı genelinde yetki verilmemişse, Chat uygulaması bir kullanıcı 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ı, Chat uygulamasının hizmet hesabı kimlik bilgilerini kullanmasına, verilere erişmesine ve işlemleri kendi adına 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, erişimi olduğu kaynakları (ör. son kullanıcıların Chat uygulamanızı eklediği alanlardaki mesajlar) oluşturmak, güncellemek, almak, listelemek veya silmek için bu yetkilendirme kapsamını destekleyen Google Chat API yöntemlerini çağırabilir. 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.* (Geliştirici Önizlemesi): Bu kapsamların kullanılması için tek seferlik yönetici onayı gerekir. Yönetici onayı almak için Google Workspace Marketplace uyumlu bir OAuth istemcisi oluşturup uygulamayı Google Workspace Marketplace SDK'sında yapılandırarak Chat uygulamasının hizmet hesabını yönetici onayı alacak şekilde hazırlayabilirsiniz. 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ında yöntemler yalnızca Chat 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şebildiği kaynakları döndürür.

Örneğin, uygulama yetkilendirmesiyle spaces.list() yönteminin çağrılması, Chat uygulamasının üyesi olduğu alanların listesini döndürür. Kullanıcı yetkilendirmesi ile spaces.list() çağrısı yapı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.

Eşzamansız 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 (Geliştirici Önizlemesi'nde mevcuttur):
  • chat.app.spaces.create
  • chat.app.spaces
Alan oluşturma Kullanıcı kimlik doğrulaması etkinken:
  • 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 (geliştirici önizlemesinde kullanılabilir):
  • chat.app.spaces
Alanları listeleme Kullanıcı kimlik doğrulaması ile:
  • chat.spaces.readonly
  • chat.spaces
Uygulama kimlik doğrulaması ile:
  • chat.bot
Alan arayın 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ı etkinken:
  • 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 (Geliştirici Önizlemesi'nde mevcuttur):
  • chat.app.spaces
Alan silme Kullanıcı kimlik doğrulaması ile:
  • chat.delete
  • chat.import
Yönetici ayrıcalıklarını kullanan kullanıcı kimlik doğrulaması ile:
  • chat.admin.delete
Uygulama kimlik doğrulaması ve yönetici onayı ile (geliştirici önizlemesinde kullanılabilir):
  • chat.app.delete
Alan için içe aktarma işlemini tamamlama Kullanıcı kimlik doğrulaması etkinken:
  • chat.import
Doğrudan mesajları 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 (geliştirici önizlemesinde kullanılabilir):
  • 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
Üyeleri listeleme 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 (geliştirici önizlemesinde kullanılabilir):
  • chat.app.memberships
Üye güncelleme Kullanıcı kimlik doğrulaması ile:
  • chat.memberships
  • chat.import
Yönetici ayrıcalıklarını kullanan kullanıcı kimlik doğrulaması ile:
  • chat.admin.memberships
Uygulama kimlik doğrulaması ve yönetici onayı ile (Geliştirici Önizlemesi'nde mevcuttur):
  • 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ı etkinken:
  • chat.messages.readonly
  • chat.messages
Uygulama kimlik doğrulaması ile:
  • chat.bot
Mesajları listeleme 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
Mesaj 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
Tepkileri 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 emoji silme Kullanıcı kimlik doğrulaması etkinken:
  • chat.customemojis
Özel emoji alma Kullanıcı kimlik doğrulaması etkinken:
  • chat.customemojis
  • chat.customemojis.readonly
Özel emojileri listeleme Kullanıcı kimlik doğrulaması etkinken:
  • chat.customemojis
  • chat.customemojis.readonly
Medya ve ekler  
Medyayı dosya eki olarak yükleme Kullanıcı kimlik doğrulaması ile:
  • chat.messages.create
  • chat.messages
  • chat.import
Medya indirme Kullanıcı kimlik doğrulaması etkinken:
  • chat.messages.readonly
  • chat.messages
Uygulama kimlik doğrulaması ile:
  • chat.bot
Mesaj eki alma Uygulama kimlik doğrulaması etkinken:
  • chat.bot
Kullanıcı okuma durumları
Kullanıcıların depolama alanı okuma durumunu alma Kullanıcı kimlik doğrulaması ile:
  • chat.users.readstate
  • chat.users.readstate.readonly
Kullanıcıların depolama alanı okuma durumunu güncelleme Kullanıcı kimlik doğrulaması ile:
  • chat.users.readstate
Kullanıcı için ileti dizisinin okunma durumunu alma Kullanıcı kimlik doğrulaması etkinken:
  • 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ıların alan bildirim ayarlarını güncelleme Kullanıcı kimlik doğrulaması ile:
  • chat.users.spacesettings
Alan etkinlikleri
Alan etkinliklerini alma Kullanıcı kimlik doğrulamasında, etkinlik türüne dayalı bir kapsam kullanmanız gerekir:
  • İletilerle 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ğrulama ile, isteğe dahil edilen 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şime geçmesinin yaygın yolları ve kimlik doğrulamanın gerekli olup olmadığı veya 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şimi etkinlikleri
Apps Komut Dosyası geri çağırma işlevleri
Google Cloud Pub/Sub
Mesajları yanıtlama:
Chat uygulaması etkileşim etkinliği kullanılarak senkronize
Apps Komut Dosyası geri çağırma dönüş değeri kullanılarak senkronize
Yeni mesaj gönderme:
Gelen webhook'ları kullanarak