Bu sayfa, Cloud Translation API ile çevrilmiştir.

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.

Sürece genel bakış

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

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

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 ve Chat uygulaması oluşturma başlıklı makaleleri inceleyin.
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.
Kaynak isteme: Uygulamanız, kimlik doğrulamayı ayarlarken belirttiğiniz kapsamlarla erişim izni ister.
İ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.
Kaynaklar için onaylanmış istek gönderin: 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.
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 jeton tarafından sınırlandırılan tüm özellikleri devre dışı bırakır.
İstenen kaynaklara erişim: Uygulamanız, Chat API'yi çağırmak ve Chat API kaynaklarına erişmek için Google'ın erişim jetonunu kullanır.
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 bilgiyi Google API'lerine erişmek için OAuth 2.0'ı kullanma başlıklı makalede bulabilirsiniz.
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 uygulaması bir yanıtı işlerken Chat API'yi veya başka bir Google API'yi çağırmadığı sürece, Chat uygulamaları 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ğrulama gerekmez

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

Google Chat uygulamaları, bir kullanıcı Chat uygulamasıyla etkileşime geçtiğinde veya Chat uygulamasını çağırdığında aşağıdakiler de dahil olmak üzere etkileşim etkinlikleri alır:

Kullanıcı bir Chat uygulamasına mesaj gönderir.
Kullanıcı bir Chat uygulamasından @bahseder.
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.

Kullanıcı, Google Chat'teki Chat uygulamasına bir mesaj gönderir.
Google Chat, mesajı uygulamaya yönlendirir.
Uygulama mesajı alır, işler ve Google Chat'e yanıt döndürür.
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, sunucu kesintisi algılandı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ında bir mesaj yayınlayın.

Aşağıdaki şemada, Chat uygulaması ile Chat alanı arasındaki eşzamansız 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.

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.
Google Chat, Chat uygulamasının kimliğini hizmet hesabı veya kullanıcı kimlik bilgileriyle doğrular.
Google Chat, uygulamanın mesajını belirli bir Chat alanına oluşturur.

Chat API kapsamları

Kullanıcılara ve uygulama incelemecilerine hangi bilgilerin gösterileceğini tanımlamak için OAuth kullanıcı rızası ekranını yapılandırın ve kapsamları seçin. Ardından, uygulamanızı daha sonra yayınlayabilmek için kaydedin.

Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını tanımlayıp 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

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 yetkilendirme ile kimlik doğrulaması yapamazsınız.

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 yetkilendirme 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örün veya düzenleyin.
`https://www.googleapis.com/auth/chat.spaces.create`	Chat'te yeni görüşmeler oluşturabilirsiniz.
`https://www.googleapis.com/auth/chat.spaces.readonly`	Chat'te sohbeti 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 tepkileri görüntüleyin, ekleyin ve silin.
`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 sohbetleri 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önetici 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örün veya güncelleyin. 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 yetki verme ile kimlik doğrulaması yapamazsınız. Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir.
`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 yetki ile kimlik doğrulaması yapamazsınız. Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizlemesi Programı kapsamında kullanılabilir.
`https://www.googleapis.com/auth/chat.app.memberships`	Chat'teki görüşmelerde 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 yetki ile kimlik doğrulaması yapamazsınız. Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir.
`https://www.googleapis.com/auth/chat.customemojis`	Chat'te özel emojileri görüntüleyin, oluşturun ve silin. Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir.
`https://www.googleapis.com/auth/chat.customemojis.readonly`	Chat'te özel emojileri görüntüleme Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizlemesi Programı kapsamında kullanılabilir.
`https://www.googleapis.com/auth/chat.users.spacesettings`	Chat kullanıcısı alan ayarlarını görüntüleyip güncelleyin. Alan kullanıcı ayarları API'lerini görme: getSpaceNotificationSetting, updateSpaceNotificationSetting Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir.

Kısıtlanmış kapsamlar

Kapsam kodu	Açıklama
`https://www.googleapis.com/auth/chat.delete`	Chat'te görüşmeleri ve 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ı verileri 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, 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 yetki ile kimlik doğrulaması yapamazsınız. Geliştirici Önizlemesi: Belirli özelliklere erken erişim sağlayan Google Workspace Geliştirici Önizleme Programı kapsamında kullanılabilir.

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

Hassas olmayan: Bu kapsamlar, en küçük yetkilendirme erişimi kapsamını sağlar ve yalnızca temel uygulama doğrulaması gerektirir. Bu şart hakkında bilgi edinmek için Doğrulama işlemine hazırlanma adımları bölümüne bakın.
Hassas: Bu kapsamlar, uygulamanızın kullanıcıdan yetki aldıktan sonra belirli bir kullanıcının Google verilerine erişmesine olanak tanır. Bu durumda ek uygulama doğrulamasından geçmeniz gerekir. Bu gereksinim hakkında bilgi edinmek için Hassas kapsamlar isteyen uygulamalara yönelik adımlar bölümüne bakın.
Kısıtlanmış: Bu kapsamlar, Google kullanıcı verilerine geniş erişim sağlar ve kısıtlanmış kapsam doğrulama sürecinden geçmenizi gerektirir. Bu şart hakkında bilgi edinmek için Google API Hizmetleri: Kullanıcı Verileri Politikası ve Belirli API Kapsamları İçin Ek Gereksinimler başlıklı makaleleri inceleyin. Kısıtlanmış kapsam isteyen uygulamalar için adımlar başlıklı makaleyi de inceleyin.

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 izin 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üklenmediyse veya alan genelinde yetki verilmediyse Chat uygulaması bir kullanıcı adına ilk kez bir işlem gerçekleştirdiğinde, kullanıcının OAuth izin ekranını kullanarak Chat uygulamasını yetkilendirmesi 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 kendi başı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ı kendisi verebilir. Yönetici veya son kullanıcı yetkilendirmesi gerekmez.
https://www.googleapis.com/auth/chat.app.* (Geliştirici Önizlemesi): Bu kapsamların kullanılabilmesi için tek seferlik yönetici onayı gerekir. Yönetici onayı almak için Google Workspace Marketplace uyumlu bir OAuth istemcisi oluşturup Google Workspace Marketplace SDK'sında uygulamayı yapılandırarak Chat uygulamasının hizmet hesabını yönetici onayı almaya hazır hale getirmeniz gerekir. 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 söz konusu yöntemler yalnızca Chat uygulamasının erişebileceği kaynakları döndürür.
Kullanıcı kimlik doğrulamasıyla, bu yöntemler yalnızca kullanıcının erişebileceğ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ı etkinken: `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 satın alma			Kullanıcı kimlik doğrulaması etkinken: `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ını kullanan kullanıcı kimlik doğrulaması durumunda: `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 (geliştirici önizlemesinde kullanılabilir): `chat.app.spaces`
Alan silme			Kullanıcı kimlik doğrulaması etkinken: `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ı etkinken: `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ı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`
Ü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ını kullanan 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ını kullanan 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ını kullanan 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ı etkinken: `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 (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ı ile: `chat.messages.readonly` `chat.messages` Uygulama kimlik doğrulaması ile: `chat.bot`
Liste mesajları		—	Kullanıcı kimlik doğrulaması etkinken: `chat.messages.readonly` `chat.messages` `chat.import`
Mesaj güncelleme			Kullanıcı kimlik doğrulaması etkinken: `chat.messages` `chat.import` Uygulama kimlik doğrulaması ile: `chat.bot`
Mesaj silme			Kullanıcı kimlik doğrulaması etkinken: `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`
Tepkiyi 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ı etkinken: `chat.customemojis`
Özel emoji silme		—	Kullanıcı kimlik doğrulaması ile: `chat.customemojis`
Özel emoji alma		—	Kullanıcı kimlik doğrulaması etkinken: `chat.customemojis` `chat.customemojis.readonly`
Özel emoji listesi		—	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`
Medyayı indirin			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ı etkinken: `chat.users.readstate` `chat.users.readstate.readonly`
Kullanıcıların depolama alanı okuma durumunu güncelleme		—	Kullanıcı kimlik doğrulaması etkinken: `chat.users.readstate`
Kullanıcı için ileti dizisinin okunma 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ı etkinken: `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ı sayesinde etkinlik türüne bağlı olarak 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ğrulaması sayesinde, 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şimde bulunduğu yaygın yöntemler ve kimlik doğrulamanın zorunlu olup olmadığı veya desteklenip desteklenmediği listelenmektedir:

Senaryo

Kimlik doğrulama gerekmez.

Kullanıcı kimlik doğrulaması desteklenir

Uygulama kimlik doğrulaması desteklenir

Şu kişilerden mesaj alma:

Chat uygulaması etkileşim etkinlikleri		—	—
Apps Komut Dosyası geri çağırma işlevleri		—	—
Google Cloud Pub/Sub	—	—

Mesajları yanıtlama:

Chat uygulaması etkileşim etkinliğini kullanarak eşzamanlı olarak		—	—
Apps Komut Dosyası geri çağırma dönüş değeri kullanılarak senkronize		—	—

Yeni mesaj gönderme:

Gelen webhook'ları kullanarak

—

Google Workspace'te kimlik doğrulama ve yetkilendirmeye genel bakış için Kimlik doğrulama ve yetkilendirme hakkında bilgi edinme başlıklı makaleyi inceleyin.
Google Cloud'da kimlik doğrulama ve yetkilendirmeye genel bakış için Kimlik doğrulamaya genel bakış başlıklı makaleyi inceleyin.
Hizmet hesapları hakkında daha fazla bilgi edinmek için Hizmet hesapları başlıklı makaleyi inceleyin.
Google API'lerinin OAuth 2.0'ı nasıl kullandığı hakkında daha fazla bilgi edinmek için Google API'lerine Erişmek için OAuth 2.0'ı Kullanma bölümüne bakın.
Kimlik doğrulama ve yetkilendirmeyi kullanıcı kimlik bilgileri veya hizmet hesabı ile ayarlayın.