Google Chat Kullanıcı Kimliklerini E-postalara Çözümleme: En Az Ayrıcalık Prensibiyle Güvenli Yaklaşım
Google Chat, ekipler arası iletişimi ve işbirliğini kolaylaştıran güçlü bir platformdur. Ancak geliştiriciler ve yöneticiler için sıklıkla karşılaşılan bir zorluk, Chat API’sinin doğrudan kullanıcı e-posta adreslerini değil, yalnızca anonimleştirilmiş kullanıcı kimliklerini sağlamasıdır. Bu durum, özellikle bir Google Chat kullanıcısının e-posta adresini gerektiren entegrasyonlar veya iş akışları oluştururken önemli bir engel teşkil eder. Bu makale, Google Chat kullanıcı kimliklerini e-postalara dönüştürmek için “en az ayrıcalık” prensibini temel alan güvenli ve verimli bir yaklaşımı ele alacaktır. Geleneksel yöntemlerin risklerini vurgulayarak, Google People API’nin bu amaca nasıl hizmet edebileceğini ve bunu yaparken güvenlik duruşumuzu nasıl güçlendirebileceğimizi detaylandıracağız.
Problem Tanımı ve Neden Önemli?
Google Chat ortamında kullanıcılar, genellikle @users/1234567890 gibi benzersiz kimliklerle temsil edilir. Bu kimlikler, platform içi etkileşimler için yeterli olsa da, harici sistemlerle entegrasyon, raporlama veya kullanıcı iletişimini kişiselleştirme gibi senaryolarda yetersiz kalır. E-posta adresleri, birçok kurumsal sistemde birincil kullanıcı tanımlayıcısı olduğundan, bu kimliklerin e-postalara çözümlenmesi kritik bir ihtiyaçtır.
Google Chat Kullanıcı Kimlikleri
Google Chat API’si, mesajlaşma veya alan yönetimi gibi işlemlerde kullanıcıları belirtmek için name alanı içinde users/ önekiyle başlayan uzun, sayısal kimlikler kullanır. Bu kimlikler, kullanıcının doğrudan tanımlanmasını engelleyerek gizliliği korumayı amaçlar. Ancak bu anonimlik, geliştiriciler için ek bir adım gerektirir.
E-posta İhtiyacı
Bir Chat kullanıcısının e-posta adresine ihtiyaç duyulan senaryolar çeşitlidir:
* Bir Chat mesajını harici bir CRM sistemindeki bir müşteri kaydıyla ilişkilendirme.
* Bir Chat bildirimini, kullanıcının e-posta adresini kullanarak bir e-posta pazarlama listesine ekleme.
* Chat etkinliğini denetlerken, anonim kimlikler yerine gerçek kullanıcı kimlikleriyle raporlama yapma.
* Özel bir botun, Chat dışındaki bir sistemde kullanıcıya özel bir işlem yapması gerektiğinde.
Güvenlik ve Gizlilik Endişeleri
Kullanıcı kimliklerini e-postalara dönüştürme süreci, güvenlik ve gizlilik açısından dikkatli bir yaklaşım gerektirir. Yanlış yapılandırılmış veya aşırı yetkili bir çözüm, hassas kullanıcı bilgilerinin sızmasına veya kötüye kullanılmasına yol açabilir. Bu nedenle, yalnızca gerekli olan minimum ayrıcalıkları talep eden bir yöntem benimsemek hayati önem taşır.
Geleneksel Çözümler ve Riskleri
Geçmişte veya bazı durumlarda hala kullanılan bazı yöntemler, Google Chat kullanıcı kimliklerini e-postalara çözümlemek için kullanılabilir, ancak bunlar genellikle “en az ayrıcalık” prensibine aykırı düşen yüksek yetkiler gerektirir ve potansiyel güvenlik riskleri taşır.
Admin SDK Kullanımı
Google Workspace Admin SDK, bir Google Workspace alanındaki tüm kullanıcıların bilgilerine erişim sağlayabilir. Directory API aracılığıyla, bir kullanıcının ID’sini (genellikle Google’ın iç ID’si, Chat ID’si ile eşleşmeyebilir) veya e-postasını sorgulayarak diğer bilgileri elde etmek mümkündür. Ancak bu API, genellikle https://www.googleapis.com/auth/admin.directory.user.readonly veya daha geniş kapsamlı yetkiler gerektirir.
Yüksek Ayrıcalıkların Sakıncaları
Admin SDK’ya erişim genellikle bir hizmet hesabı veya bir yönetici kullanıcısı aracılığıyla sağlanır. Bu tür hesaplara verilen geniş yetkiler, uygulamanın yalnızca belirli bir kullanıcının e-postasını bulması gerektiğinde bile tüm dizine erişmesine izin verir. Bu durum, uygulamanın güvenliği ihlal edildiğinde veya yanlış yapılandırıldığında, tüm kuruluşun kullanıcı verilerinin risk altında olmasına neden olabilir.
Veri Sızıntısı Potansiyeli
Geniş yetkilere sahip bir uygulamanın ele geçirilmesi durumunda, saldırganlar tüm kullanıcı listelerine, e-posta adreslerine, telefon numaralarına ve diğer hassas bilgilere erişebilir. Bu, hem yasal (GDPR, KVKK gibi) hem de itibar açısından ciddi sonuçlar doğurabilir. Bu nedenle, her zaman göreve özel ve sınırlı yetkilerle çalışmak en iyi uygulamadır.
En Az Ayrıcalık Prensibi Nedir?
En az ayrıcalık prensibi (Principle of Least Privilege – PoLP), bir kullanıcının, programın veya sürecin bir görevi yerine getirmek için yalnızca kesinlikle gerekli olan minimum erişim haklarına sahip olması gerektiğini belirten bir güvenlik kavramıdır. Bu prensip, bilgi güvenliğinin temel taşlarından biridir.
Temel Tanım ve Önemi
PoLP, yetkisiz erişimden kaynaklanan potansiyel zararı en aza indirmeyi amaçlar. Bir sistemin veya kullanıcının yalnızca ihtiyaç duyduğu kaynaklara ve işlemlere erişmesine izin vererek, bir güvenlik ihlali durumunda ortaya çıkabilecek hasarı sınırlar. Örneğin, bir kullanıcının sadece okuma yetkisine ihtiyacı varsa, ona yazma veya silme yetkisi verilmemelidir.
Google Workspace Bağlamında Uygulama
Google Workspace API’leri ile çalışırken, PoLP, uygulamanızın yalnızca belirli bir görevi yerine getirmek için gereken en dar kapsamlı (scope) izinleri talep etmesi anlamına gelir. Örneğin, sadece bir kullanıcının temel profil bilgilerine erişmeniz gerekiyorsa, tüm dizini okuma veya yönetme yetkisi isteyen bir kapsam kullanmamalısınız.
Güvenlik Duruşunu Güçlendirme
En az ayrıcalık prensibini uygulamak, genel güvenlik duruşunuzu önemli ölçüde güçlendirir:
* Saldırı Yüzeyini Azaltır: Bir sistemin veya uygulamanın sahip olduğu yetkiler ne kadar azsa, saldırganların kötüye kullanabileceği potansiyel açıklar da o kadar az olur.
* İhlal Etkisini Sınırlar: Bir güvenlik ihlali meydana geldiğinde, saldırganın erişebileceği veri miktarı ve yapabileceği eylemler sınırlı kalır.
* Uyumluluğu Kolaylaştırır: KVKK, GDPR gibi veri koruma düzenlemelerine uyum sağlamak için gereksiz veri erişimini kısıtlamak önemlidir.
* Denetlenebilirliği Artırır: Hangi uygulamanın neye eriştiğini anlamak ve denetlemek daha kolay hale gelir.
Önerilen En Az Ayrıcalıklı Yaklaşım: People API
Google Chat kullanıcı kimliklerini e-postalara dönüştürmek için en az ayrıcalık prensibine uygun, güvenli ve verimli bir yöntem Google People API’sini kullanmaktır. Bu API, kullanıcıların temel profil bilgilerine, doğru kapsamlarla erişim sağlar.
People API’ye Genel Bakış
Google People API, bir kullanıcının Google hesabındaki kişi verilerine (profil, kişiler) erişim sağlar. Bu API’nin en önemli özelliklerinden biri, bir kullanıcının Google ID’sini kullanarak temel profil bilgilerini, dolayısıyla e-posta adresini sorgulayabilmesidir. Bu, Chat kullanıcı kimliklerini çözmek için ideal bir araç haline getirir, çünkü Admin SDK kadar geniş yetkiler gerektirmez.
Gerekli Kapsamlar
People API’yi kullanırken, Chat kullanıcısının e-postasını almak için ihtiyacımız olan en dar kapsam, https://www.googleapis.com/auth/userinfo.email veya https://www.googleapis.com/auth/userinfo.profile‘dır.
* userinfo.email: Yalnızca kullanıcının birincil e-posta adresine erişim sağlar. Bu, genellikle en az ayrıcalıklı ve tercih edilen kapsamdır.
* userinfo.profile: Kullanıcının temel profil bilgilerine (ad, soyad, fotoğraf, e-posta) erişim sağlar. Eğer ad veya soyad gibi ek bilgilere de ihtiyacınız varsa bu kullanılabilir.
Bu kapsamlar, Admin SDK’nın gerektirdiği geniş dizin erişiminden çok daha sınırlıdır ve yalnızca belirli bir kullanıcının halka açık veya temel profil bilgilerine odaklanır.
Kullanıcı Kimliklerini Çözümleme Akışı
1. Chat Kullanıcı Kimliği Elde Etme: Google Chat API’sinden veya bir Chat etkinliğinden (@users/1234567890 formatında) kullanıcı kimliğini alın.
2. Google ID’ye Dönüştürme: Chat kullanıcı kimliğinin sayısal kısmını (1234567890) Google ID olarak kullanın. Google Chat API’sinin sağladığı bu sayısal ID, aslında kullanıcının Google ID’sidir.
3. People API Çağrısı: People API’nin people.get metodunu, resourceName olarak people/1234567890 ve personFields olarak emailAddresses (veya names, photos gibi ek alanlar) ile çağırın.
4. E-posta Adresini Alma: API yanıtından kullanıcının e-posta adresini çıkarın.
Yetkilendirme ve Kimlik Doğrulama
People API’ye erişim için iki ana yetkilendirme yöntemi vardır:
* Hizmet Hesabı (Service Account): Uygulamanızın kendi adına Google API’lerini çağırması gerektiğinde kullanılır. Bu durumda, hizmet hesabına, ilgili kullanıcının kimliğine bürünme (domain-wide delegation) yetkisi verilmesi gerekir. Bu, hizmet hesabının belirli bir kullanıcı adına People API’yi çağırmasına olanak tanır. Yalnızca userinfo.email kapsamı ile yetkilendirilmelidir.
* OAuth 2.0 (Kullanıcı Tarafından Yetkilendirme): Uygulamanızın, API’yi çağıran son kullanıcının izniyle onun adına işlem yapması gerektiğinde kullanılır. Bu, uygulamanın bir web arayüzü varsa ve kullanıcıların kendi e-postalarını çözümlemesine izin veriyorsa uygun olabilir.
En az ayrıcalık prensibi doğrultusunda, genellikle bir hizmet hesabı ve domain-wide delegation ile userinfo.email kapsamını kullanmak, uygulamanın yalnızca gerektiğinde ve belirli kullanıcılar için e-posta çözümlemesi yapmasını sağlar.
Uygulama Adımları ve Kod Örnekleri
Bu bölümde, People API’yi kullanarak Google Chat kullanıcı kimliklerini e-postalara çözümleme sürecini adım adım ele alacağız ve Python ile bir kod örneği sunacağız.
Google Cloud Projesi Oluşturma
1. Google Cloud Console’a Giriş Yapın: console.cloud.google.com adresine gidin.
2. Yeni Proje Oluşturun: Mevcut bir projeniz yoksa, yeni bir proje oluşturun.
3. Faturalandırmayı Etkinleştirin: API kullanımı için faturalandırmanın etkinleştirildiğinden emin olun (ücretsiz katman limitleri genellikle yeterlidir).
API’leri Etkinleştirme ve Kimlik Bilgileri
1. People API’yi Etkinleştirin: Cloud Console’da “API’ler ve Hizmetler” > “Kitaplık” bölümüne gidin. “Google People API”yi arayın ve etkinleştirin.
2. Hizmet Hesabı Oluşturun: “API’ler ve Hizmetler” > “Kimlik Bilgileri” bölümüne gidin. “Kimlik Bilgileri Oluştur” > “Hizmet Hesabı” seçeneğini seçin. Bir ad verin ve bir rol atamayın (veya “Temel” > “Görüntüleyici” gibi en dar rolü atayın, çünkü yetkilendirme kapsamlarla yönetilecek). JSON anahtarını oluşturun ve bilgisayarınıza indirin.
3. Alan Geneli Yetkilendirme (Domain-Wide Delegation) Yapılandırma: Eğer bir hizmet hesabı kullanıyorsanız ve Google Workspace alanınızdaki kullanıcılar adına işlem yapacaksanız, Google Workspace Yönetici konsolunuzda (admin.google.com) hizmet hesabına alan geneli yetkilendirme vermeniz gerekir.
* Yönetici konsolunda “Güvenlik” > “Erişim ve Veri Kontrolü” > “API Kontrolleri” bölümüne gidin.
* “Alan Geneli Yetkilendirme” altında “Uygulamaları Yönet”e tıklayın.
* Hizmet hesabınızın istemci kimliğini (Google Cloud Console’da hizmet hesabı detaylarında bulunur) ve gerekli API kapsamını (https://www.googleapis.com/auth/userinfo.email) ekleyin.
Python ile Örnek Kod
Aşağıdaki Python kodu, bir Google Chat kullanıcı kimliğini (örneğin, 1234567890) kullanarak People API aracılığıyla kullanıcının e-posta adresini nasıl alacağınızı gösterir.
import google.auth
from google.auth.transport.requests import Request
from google.oauth2.service_account import Credentials
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
def resolve_chat_user_id_to_email(chat_user_id_numeric, impersonated_user_email, service_account_file):
"""
Google Chat kullanıcı kimliğini People API aracılığıyla e-posta adresine dönüştürür.
Args:
chat_user_id_numeric (str): Google Chat kullanıcı kimliğinin sayısal kısmı (örn: "1234567890").
impersonated_user_email (str): Hizmet hesabının kimliğine bürüneceği bir Google Workspace kullanıcısının e-postası.
Bu kullanıcı, hedef kullanıcının e-postasını görme yetkisine sahip olmalıdır.
service_account_file (str): Hizmet hesabı JSON anahtar dosyasının yolu.
Returns:
str: Kullanıcının e-posta adresi veya None eğer bulunamazsa.
"""
# People API için gerekli kapsam
SCOPES = ['https://www.googleapis.com/auth/userinfo.email']
try:
# Hizmet hesabı kimlik bilgileri ile kimlik doğrulama
creds = Credentials.from_service_account_file(
service_account_file, scopes=SCOPES
)
# Alan geneli yetkilendirme (Domain-wide delegation) için kimliğe bürünme
creds = creds.with_subject(impersonated_user_email)
# HTTP isteği için bir Request nesnesi oluşturma
creds.refresh(Request())
# People API servisini oluşturma
service = build('people', 'v1', credentials=creds)
# People API'yi kullanarak kullanıcının bilgilerini alma
# resourceName formatı "people/GoogleID" şeklindedir
# personFields olarak sadece "emailAddresses" istiyoruz
person = service.people().get(
resourceName=f'people/{chat_user_id_numeric}',
personFields='emailAddresses'
).execute()
if 'emailAddresses' in person and person['emailAddresses']:
for email_address in person['emailAddresses']:
if email_address.get('value'):
return email_address['value']
return None
except HttpError as err:
print(f"API hatası oluştu: {err}")
if err.resp.status == 404:
print(f"Kullanıcı ID'si {chat_user_id_numeric} bulunamadı.")
elif err.resp.status == 403:
print("Yetkilendirme hatası. Hizmet hesabının veya kimliğine bürünülen kullanıcının yeterli izni yok.")
return None
except Exception as e:
print(f"Beklenmedik bir hata oluştu: {e}")
return None
# Örnek kullanım:
if __name__ == '__main__':
# Bu değerleri kendi ortamınıza göre güncelleyin
CHAT_USER_ID = "1234567890" # Google Chat'ten aldığınız sayısal ID
IMPERSONATED_USER = "admin-user@yourdomain.com" # Alanınızdaki herhangi bir kullanıcının e-postası (genellikle yönetici)
SERVICE_ACCOUNT_KEY_PATH = "path/to/your/service-account-key.json" # JSON anahtar dosyanızın yolu
email = resolve_chat_user_id_to_email(CHAT_USER_ID, IMPERSONATED_USER, SERVICE_ACCOUNT_KEY_PATH)
if email:
print(f"Chat Kullanıcı ID'si {CHAT_USER_ID} için e-posta: {email}")
else:
print(f"Chat Kullanıcı ID'si {CHAT_USER_ID} için e-posta bulunamadı veya bir hata oluştu.")Not: impersonated_user_email parametresi, hizmet hesabının kimliğine bürüneceği bir kullanıcının e-posta adresidir. Bu kullanıcı, People API'ye erişim yetkisine sahip olmalıdır (yani, alan geneli yetkilendirme bu kullanıcı adına çalışacaktır). Genellikle, bu bir yönetici hesabı veya People API'ye erişimi olan herhangi bir kullanıcı olabilir.
Hata Yönetimi ve En İyi Uygulamalar
* API Hatalarını Yakalayın: googleapiclient.errors.HttpError gibi özel hataları yakalayarak API yanıtlarını doğru şekilde işleyin (örneğin, 404 Not Found, 403 Forbidden).
* Yeniden Deneme Mekanizmaları: Geçici ağ sorunları veya API kota limitleri için yeniden deneme mantığı uygulayın (üstel geri çekilme ile).
* Günlükleme: Tüm API çağrılarını ve hataları uygun bir günlükleme sistemiyle kaydedin.
* Kimlik Bilgilerini Güvenli Saklayın: Hizmet hesabı anahtar dosyasını asla açık kaynak kod depolarında saklamayın. Ortam değişkenleri veya güvenli bir sır yöneticisi kullanın.
Alternatifler ve Sınırlamalar
Her ne kadar People API en az ayrıcalıklı ve önerilen yöntem olsa da, bazı alternatifler ve her yaklaşımın kendine özgü sınırlamaları vardır.
Google Chat API'nin Sınırlamaları
Google Chat API'si, doğrudan kullanıcı e-posta adreslerini sağlamaz. Bunun temel nedeni, gizliliği korumak ve uygulamaların gereksiz yere hassas bilgilere erişmesini engellemektir. Bu tasarım kararı, geliştiricileri People API gibi daha spesifik ve yetkilendirme açısından daha granüler API'lere yönlendirir. Gelecekte Chat API'sinin bu konuda bir gelişme sunup sunmayacağı belirsizdir, ancak mevcut durumda doğrudan e-posta alma yeteneği yoktur.
Özel Durumlar ve Çözümler
* Harici Kullanıcılar: Eğer Google Chat alanınızdaki bir kullanıcı, kuruluşunuz dışından (misafir kullanıcı) ise, People API aracılığıyla bu kullanıcının e-posta adresini doğrudan alamayabilirsiniz. People API genellikle Google Workspace dizininizdeki dahili kullanıcılar için tasarlanmıştır. Bu tür durumlarda, Chat mesajı içeriğinden e-posta adresini ayrıştırmak veya kullanıcının kendisinden e-posta adresini talep etmek gibi alternatif yöntemler düşünülmelidir.
* Silinmiş Kullanıcılar: Bir kullanıcı Google Workspace'ten silindiyse, People API bu kullanıcının kimliğini çözemeyecektir. Bu senaryolarda, uygulamanızın uygun hata yönetimi ve kullanıcı bilgilendirmesi yapması önemlidir.
Performans ve Kota Yönetimi
People API'nin de belirli kota limitleri vardır. Büyük ölçekli uygulamalar veya çok sayıda kullanıcı kimliğini aynı anda çözümlemeniz gerektiğinde bu limitleri göz önünde bulundurmanız gerekir.
* Toplu İşlemler (Batch Requests): Birden fazla kullanıcı kimliğini tek bir API çağrısında çözümlemek için People API'nin toplu işlem yeteneklerini kullanabilirsiniz. Bu, API çağrısı sayısını azaltarak kota kullanımını optimize eder ve performansı artırır.
* Önbellekleme: Sıkça sorgulanan kullanıcıların e-posta adreslerini yerel bir veritabanında veya önbellekte saklayarak gereksiz API çağrılarını önleyebilirsiniz. Önbelleği belirli aralıklarla yenilemeyi unutmayın.
* Hata Yönetimi: Kota limitlerine ulaşıldığında API'nin döndüreceği hataları (genellikle 429 Too Many Requests) yakalayın ve üstel geri çekilme (exponential backoff) stratejisi ile yeniden denemeler yapın.
Güvenlik ve Gizlilik En İyi Uygulamaları
En az ayrıcalık prensibi, güvenli bir mimarinin sadece bir parçasıdır. Genel güvenlik ve gizlilik duruşunuzu güçlendirmek için ek en iyi uygulamaları benimsemek önemlidir.
Erişim Kontrolü ve Rol Yönetimi
* Hizmet Hesabı Yetkileri: Hizmet hesaplarına yalnızca görevi için gerekli olan minimum yetkileri verin. Alan geneli yetkilendirme kullanıyorsanız, yalnızca userinfo.email gibi dar kapsamları ekleyin.
* IAM Rolleri: Google Cloud projenizde, hizmet hesaplarına veya kullanıcı hesaplarına atadığınız IAM (Identity and Access Management) rollerini dikkatlice yönetin. Gereksiz veya geniş yetkilere sahip rollerden kaçının.
* Sır Yönetimi: API anahtarları ve hizmet hesabı JSON dosyaları gibi hassas kimlik bilgilerini güvenli bir şekilde saklayın. Google Secret Manager gibi bir sır yönetimi hizmeti kullanmak en iyi yaklaşımdır.
Veri Saklama ve Silme Politikaları
* Gereksiz Veri Saklamayın: Çözümlenen e-posta adreslerini, göreviniz için kesinlikle gerekli olandan daha uzun süre saklamayın.
* Veri Minimallik: Yalnızca ihtiyacınız olan veriyi toplayın ve saklayın. Örneğin, sadece e-posta adresine ihtiyacınız varsa, kullanıcının tam profilini saklamayın.
* Silme Politikaları: Sakladığınız veriler için net veri saklama ve silme politikaları oluşturun ve uygulayın.
Denetim Kayıtları ve İzleme
* API Etkinliği İzleme: Google Cloud'daki Cloud Audit Logs'u kullanarak People API çağrılarını ve hizmet hesabı etkinliğini izleyin. Bu, olası kötüye kullanımları veya yetkisiz erişim girişimlerini tespit etmenize yardımcı olur.
* Uygulama Günlükleri: Uygulamanızın kendi içinde de kimlik çözümleme işlemlerini, başarıları ve hataları kaydedin. Bu günlükler, sorun giderme ve güvenlik analizi için kritik öneme sahiptir.
* Uyarılar Kurun: Olağandışı API kullanım modelleri (örneğin, normalden çok daha fazla çağrı) veya yetkilendirme hataları için otomatik uyarılar yapılandırın.
Sonuç
Google Chat kullanıcı kimliklerini e-postalara çözümlemek, birçok entegrasyon ve iş akışı için vazgeçilmez bir gereksinimdir. Ancak bu süreç, güvenlik ve gizlilik açısından dikkatle ele alınmalıdır. "En az ayrıcalık" prensibini benimseyerek ve Google People API'sini doğru kapsamlarla kullanarak, bu ihtiyacı güvenli ve verimli bir şekilde karşılayabiliriz. Admin SDK gibi daha geniş yetkiler gerektiren yöntemlerden kaçınmak, potansiyel veri sızıntısı risklerini azaltır ve uygulamanızın genel güvenlik duruşunu güçlendirir. Bu makalede sunulan adımlar ve kod örnekleri, geliştiricilere bu prensipleri pratik olarak uygulamaları için bir yol haritası sunmaktadır. Unutmayın, güvenlik bir süreçtir ve sürekli dikkat ile iyileştirme gerektirir.
SSS (Sık Sorulan Sorular)
Neden Google Chat API'si doğrudan e-posta sağlamıyor?
Google Chat API'si, kullanıcı gizliliğini korumak amacıyla doğrudan e-posta adreslerini sağlamaz. Bunun yerine, anonimleştirilmiş kullanıcı kimlikleri sunar. Bu tasarım, uygulamaların yalnızca belirli bir görev için gerekli olan minimum bilgiye erişmesini teşvik eder.
People API kullanmak ne kadar güvenli?
People API, doğru kapsamlar ve "en az ayrıcalık" prensibiyle kullanıldığında oldukça güvenlidir. Örneğin, sadece userinfo.email kapsamını kullanmak, uygulamanızın yalnızca kullanıcının e-posta adresine erişmesini sağlar ve diğer hassas bilgilere erişimi engeller. Alan geneli yetkilendirme ile bir hizmet hesabı kullanmak, son kullanıcı yetkilendirmesine kıyasla daha kontrollü bir ortam sunar.
Hangi API kapsamlarına ihtiyacım var?
Yalnızca kullanıcının e-posta adresini almak istiyorsanız, en dar kapsam https://www.googleapis.com/auth/userinfo.email'dir. Eğer kullanıcının adı veya profil fotoğrafı gibi ek temel bilgilere de ihtiyacınız varsa, https://www.googleapis.com/auth/userinfo.profile kapsamını kullanabilirsiniz.
Bu yöntem tüm Google Chat kullanıcıları için çalışır mı?
Bu yöntem, Google Workspace dizininizdeki dahili kullanıcılar için sorunsuz çalışır. Harici (misafir) kullanıcılar için People API doğrudan çözümleme yapamayabilir, çünkü bu kullanıcılar genellikle sizin Google Workspace dizininizin bir parçası değildir. Bu tür durumlar için alternatif çözüm yolları düşünülmelidir.
Kota limitleri var mı?
Evet, Google People API'nin de diğer Google API'leri gibi belirli kullanım kota limitleri vardır. Büyük ölçekli uygulamalar için toplu istekler, önbellekleme ve üstel geri çekilme ile hata yönetimi gibi stratejiler kullanarak kota kullanımını optimize etmek önemlidir. Mevcut kota limitlerini Google Cloud Console'dan kontrol edebilirsiniz.