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 dokümanda, Chat uygulamaları ve Chat API istekleri için kimlik doğrulama ve yetkilendirmenin işleyiş şekli açıklanmaktadır.

İşleme genel bakış

Aşağıdaki şemada, Google Chat için 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
Ş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 geliştirme yapma ve Chat uygulaması geliştirme başlıklı makaleleri inceleyin.

  2. Chat API'yi çağırma: Uygulamanız Chat API'yi çağırdığında kimlik doğrulama bilgilerini Chat API'ye gönderir. Uygulamanızın kimlik doğrulaması bir hizmet hesabı üzerinden yapılı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 isteme: Uygulamanız, kimlik doğrulamayı ayarlarken belirttiğiniz kapsamlarla erişim ister.

  4. İzin isteme: 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 kullanıcı rızası ekranı gösterir. Hizmet hesabı ile kimlik doğrulama için kullanıcı rızası 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 onaylanan kapsamları bir istekte birleştirir. İstek, erişim jetonu almak için 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şme: 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 kullanım süresinden 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 isteme: 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 istekle sonuçlanır (3-6. adımlar).

Chat 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, kullanıcı adına Chat alanı oluşturma veya Chat alanındaki kişilerin listesini alma gibi görevleri de tamamlayabilirler.

Chat uygulaması, 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.

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

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

Google Chat uygulamalarının, kullanıcı etkileşimlerini eşzamanlı olarak alıp yanıtlamak için kullanıcı veya Chat uygulaması olarak kimlik doğrulaması yapması gerekmez.

Google Chat uygulamaları, bir kullanıcı bir Chat uygulamasıyla etkileşime girdiğinde veya uygulamayı çağırdığında etkinlik nesneleri alır. Bu nesneler arasında şunlar bulunur:

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

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

Chat uygulaması kullanıcı etkileşimleri için yetkilendirme gerekmez.
Şekil 2. Chat uygulaması kullanıcı etkileşimleri 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, yanıtı kullanıcıya veya bir alanda gösterir.

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

Asenkron mesajlar kimlik doğrulama gerektirir

Eşzamansız mesajlar, bir Chat uygulamasının Chat API'ye istek göndermesiyle gerçekleşir. Bu işlem için kimlik doğrulama ve yetkilendirme gerekir.

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

  • Kesintiyi araştırmak ve düzeltmek için özel bir Chat alanı oluşturun.
  • Chat alanına kullanıcı ekleyin.
  • Kesintiyle ilgili ayrıntıları paylaşmak için Chat alanına mesaj gönderin.

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

Asenkron mesajlar için kimlik doğrulama gerekiyor
Şekil 3. Asenkron mesajlar kimlik doğrulama gerektirir.

  1. Chat uygulaması, spaces.messages.create yöntemini kullanarak Chat API'yi çağırıp 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 Chat alanında oluşturur.

Chat API kapsamları

Kullanıcılara ve uygulama incelemecilerine hangi bilgilerin gösterileceğini tanımlamak ve uygulamanızı daha sonra yayınlayabilmek için kaydetmek üzere OAuth kullanıcı rızası 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 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

Chat uygulamalarının sohbetleri görüntülemesine ve mesaj göndermesine olanak tanır.

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ü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 Kendini Google Chat'teki görüşmelere ekleyip 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 sohbetleri 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 bir Chat uygulaması olarak 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ı gerekir.

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.

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

Chat'te meta verileri (geçmiş ayarları dahil) Chat uygulaması olarak görüntüleme. Yönetici onayı gerekir.

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.

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

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

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.

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

Chat uygulaması olarak Chat'teki görüşmelerde ve alanlarda üyeleri görme, ekleme, güncelleme ve kaldırma. Yönetici onayı gerekir.

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.

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

Chat'teki görüşmelerde ve alanlarda bulunan üyeleri Chat uygulaması olarak görme. Yönetici onayı gerekir.

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.

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
https://www.googleapis.com/auth/chat.users.sections Chat'te bölümlerinizi görüntüleme, oluşturma, güncelleme ve silme; Chat'te bölüm öğelerinizi taşıma ve listeleme
https://www.googleapis.com/auth/chat.users.sections.readonly Chat'te bölümlerinizi ve bölüm öğelerini görüntüleme

Kısıtlanmış kapsamlar

Kapsam kodu Açıklama
https://www.googleapis.com/auth/chat.delete Chat'te görüşmeler ile alanları silme ve 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 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üleme
https://www.googleapis.com/auth/chat.app.messages.readonly

Chat'te mesajları ve tepkileri Chat uygulaması olarak görüntüleme. Yönetici onayı gerekir.

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.

https://www.googleapis.com/auth/chat.admin.delete Yöneticinin alanına ait görüşmeler ile alanları silme ve Chat'teki ilişkili dosyalara erişimi kaldırma
https://www.googleapis.com/auth/chat.app.delete

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

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.

Ö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 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ının Chat API ile kimlik doğrulama ve yetkilendirme yapmasının iki yolu vardır:

Kullanıcı kimlik doğrulaması
Kullanıcı kimlik doğrulaması, Chat uygulamasının kullanıcı verilerine erişmesine ve kullanıcı adına işlem yapmasına olanak tanır. OAuth kapsamları, yetkili verileri ve işlemleri belirtir. Chat uygulaması yönetici tarafından yüklenmediyse veya uygulamaya alan genelinde yetki verilmediyse Chat uygulaması bir kullanıcı adına ilk kez işlem gerçekleştirdiğinde kullanıcının OAuth kullanıcı rızası 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 uygulama yetkilendirmesini destekleyen OAuth yetkilendirme kapsamlarını OAuth kullanıcı rızası ekranına 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 olan 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.*: 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şturup 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ı kullanıldığında yöntemler yalnızca Chat uygulamasının erişebileceği kaynakları döndürür.
  • Kullanıcı kimlik doğrulaması kullanıldığında 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() yöntemini çağırmak, kullanıcının üyesi olduğu alanların listesini döndürü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ı listelenmiştir:

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 alma 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
Alan arama — Yönetici ayrıcalıkları kullanılarak Kullanıcı kimlik doğrulaması yapıldığında:
  • 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ı yapıldığında:
  • chat.admin.delete
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.delete
Bir 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ı yapıldığında:
  • chat.admin.memberships
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.memberships
Üye alma 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ı yapıldığında:
  • 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
Üye güncelleme Kullanıcı kimlik doğrulaması ile:
  • chat.memberships
  • chat.import
Yönetici ayrıcalıkları kullanılarak kullanıcı kimlik doğrulaması yapıldığında:
  • 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
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.messages.readonly
Mesajları listeleme Kullanıcı kimlik doğrulaması ile:
  • chat.messages.readonly
  • chat.messages
  • chat.import
Uygulama kimlik doğrulaması ve yönetici onayı ile:
  • chat.app.messages.readonly
Mesajlarda arama yapma — Kullanıcı kimlik doğrulaması ile:
  • chat.messages.readonly
  • chat.messages
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
Mesaj sabitleme — Kullanıcı kimlik doğrulaması ile:
  • chat.spaces.pins
  • chat.spaces
Mesajın sabitlemesini kaldırma — Kullanıcı kimlik doğrulaması ile:
  • chat.spaces.pins
  • chat.spaces
Sabitlenmiş mesajları listeleme — Kullanıcı kimlik doğrulaması ile:
  • chat.spaces.pins.readonly
  • chat.spaces.readonly
  • chat.spaces.pins
  • chat.spaces
Mesajdaki kartları güncelleme — 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 alma — 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  
Medyayı dosya eki olarak yükleme — Kullanıcı kimlik doğrulaması ile:
  • chat.messages.create
  • chat.messages
  • chat.import
Medya öğesi indirme Kullanıcı kimlik doğrulaması ile:
  • chat.messages.readonly
  • chat.messages
Uygulama kimlik doğrulaması ile:
  • chat.bot
İleti ekini 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
Kullanıcının mesaj 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, 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
Bölümler  
Bölüm oluşturma — Kullanıcı kimlik doğrulaması ile:
  • chat.users.sections
Bölüm silme — Kullanıcı kimlik doğrulaması ile:
  • chat.users.sections
Bölümleri listeleme — Kullanıcı kimlik doğrulaması ile:
  • chat.users.sections
  • chat.users.sections.readonly
Bölüm güncelleme — Kullanıcı kimlik doğrulaması ile:
  • chat.users.sections
Bölüm konumlandırma — Kullanıcı kimlik doğrulaması ile:
  • chat.users.sections
Bölüm Öğeleri  
Bölüm öğesini taşıma — Kullanıcı kimlik doğrulaması ile:
  • chat.users.sections
Bölüm öğelerini listeleme — Kullanıcı kimlik doğrulaması ile:
  • chat.users.sections
  • chat.users.sections.readonly

Chat uygulaması etkileşim etkinlikleri için

Aşağıdaki tabloda, kullanıcıların Chat uygulamalarıyla etkileşim kurma yöntemleri ve kimlik doğrulamanın gerekli 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şim etkinlikleri — —
Apps Komut Dosyası geri çağırmaları — —
Google Cloud Pub/Sub — —
Mesajları yanıtlama:
Chat uygulaması etkileşim etkinliği kullanarak eşzamanlı olarak — —
Apps Komut Dosyası geri çağırma dönüş değeri kullanarak eşzamanlı olarak — —
Yeni mesaj gönderme:
Gelen webhook'lar ile — —