Desteği sonlandırma planı

Bu belgede, Play Games Hizmetleri v1 SDK'sının desteğinin sonlandırılma takvimi listelenmektedir.

Google ile Oturum Açma (GSI) API'sinin desteğinin sonlandırılmasının ve planlı kapatmanın ardından Play Games Hizmetleri v1 SDK'sının ve API'lerinin desteğini sonlandırıyoruz. En yeni özelliklerden yararlanmak için oyununuzu Play Games Hizmetleri v2 SDK'sına taşımanız gerekir.

Kullanımdan kaldırma zaman çizelgeleri aşağıdaki gibidir:

Tarih	Kullanımdan kaldırma dönüm noktası	Etki	Geliştirici işlemi
Mayıs 2026	GSI API'nin kaldırılması	Bir oyuna, Play Games Hizmetleri v1 API'si dışında Google kimlik doğrulamasına dayanmayan yeni özellikler (ör. canlı etkinlikler, görevler veya haritalar) eklenirse bu özellikler çalışmaya devam eder. Oyununuzda, kimlik doğrulama yükseltmesi gerektiren Play Games Hizmetleri v1 dışındaki bir Google SDK'sı veya üçüncü taraf SDK'sı kullanılıyorsa bu SDK'nın en son sürümüne yükseltme yapmak derleme hatalarına neden olabilir.	Derleme hatasıyla karşılaştığınızda burada belirtilen çözüm yolunu izleyin. Çözüm 2026'nın 2. çeyreğinin sonuna doğru yayınlandıktan hemen sonra, burada belirtilen çözüm yoluna göre Play Games Hizmetleri v2'ye geçiş yaptığınızdan emin olun.
15 Haziran 2026	Play Games Hizmetleri v1 API'lerinin kaldırılması	GSI API'lerinin kaldırıldığı yeni bir Play Games Hizmetleri v1 SDK'sı yayınlanacak. Mevcut Play Games Hizmetleri v1 özelliklerinde başka hata düzeltmeleri veya güncellemeler yapılmayacak. Mevcut bir v1 uygulaması en son Play Oyun Hizmetleri v1 sürümüne yükseltilirse bu yeni sürümdeki Play Oyun Hizmetleri işlevleri çalışmayı durdurur.	Play Games Hizmetleri v1'deki oyunlar, v1 API'lerini kaldıran com.google.android.gms:play-services-games:25.0.0 sürümüne yükseltmemelidir. Play Games Hizmetleri v2'ye geçiş yapmamış oyunlarda, play-services-auth Mayıs 2026'dan itibaren GSI sağlamayacağı için derleme hataları yaşanabilir. Önceki bölümde belirtilen zaman çizelgesine göre oyunlar, diğer SDK'ları yükseltme konusunda dikkatli olabilir ve Play Games Hizmetleri v2'ye taşınana kadar diğer SDK'ların yeni Kimlik Bilgisi Yöneticisi SDK'sını kullanmadığından emin olabilir.
Mayıs 2027	Play Games Hizmetleri v1'in kapatılması	Play Games Hizmetleri v1'den gelen tüm trafik, oyun derlenmeden engelleniyor. Mevcut Play Games Hizmetleri v1 API'leri üretim ortamında çalışmayı durdurur.	Oyuncu oryantasyonu ve girişinde aksaklık yaşamamak için bu son tarihten önce Play Oyun Hizmetleri v2'ye geçiş yapmanız gerekir.

• Eylül 2025'ten sonra Games v1 SDK'sı ve API'lerinin desteği sonlandırılacak. Önceki v1 entegrasyonlarına sahip mevcut uygulamalar çalışmaya devam eder. Google Play, v1 SDK'sını ve API'lerini kullanan yeni yayınların yayınlanmasını engeller.

• Desteği sonlandırılan API'ler 15 Haziran 2026'dan itibaren SDK'dan kaldırılacak.

• Games v1 SDK'sı Haziran 2027'den itibaren kaldırılacak. SDK'nın önceki sürümlerini kullanıyor olsanız bile bu API'lere yapılan çağrılar başarısız olur.

Aşağıdaki tabloda, games v1 (SDK) sürümleri, desteğin sonlandırılma tarihleri ve taşıma kılavuzları listelenmektedir:

SDK sürümü	Çıkış tarihi	Taşıma rehberi
play-services-games:v24.0.0	12 Eylül 2025 Kullanımdan kaldırıldı	v2'ye(Java veya Kotlin) geçiş yapma
v0.10.15 Unity	17 Eylül 2025 Kullanımdan kaldırıldı	v2'ye(Unity) taşıma
play-services-games:v25.0.0	15 Haziran 2026 Play Games Hizmetleri v1 API'si SDK'dan kaldırılacak.	v2'ye(Java veya Kotlin) geçiş yapma

GSI API'nin kaldırılmasının örnek etkisi

Bir SDK'nın (SDK1) oyuncunun Google Hesabı'ndan arkadaş listesi aldığı bir senaryoyu ele alalım. Oyuncuların bu özelliği kullanabilmesi için Google kimlik doğrulama SDK'sını kullanarak Google Hesaplarının kimliğini doğrulamaları gerekir.

Aşağıdaki durumlarda Google Kimlik Doğrulama SDK'sını güncellemeniz gerekebilir:

• Kimlik doğrulama akışındaki kritik bir hatayı düzeltir.
• Kimlik Bilgisi Yöneticisi SDK'sının sunduğu yeni geçiş anahtarı deneyimlerini uygulayın.

Aşağıdaki tabloda, oyununuzun kimlik doğrulama entegrasyonunu güncellemeye yönelik üç senaryo açıklanmaktadır:

• 1. Senaryo: SDK1, en yeni Google Authentication SDK'sına yükseltilir.
• 2. Senaryo: SDK1, Kimlik Bilgisi Yöneticisi ile entegre olur ve Google Authentication SDK'sı değişmeden kalır.
• 3. Senaryo: SDK1, Kimlik Bilgisi Yöneticisi ile entegre olur ve Google Authentication SDK'sını kaldırır.

Özellik	Senaryo 1	Senaryo 2	Senaryo 3
Kimlik doğrulama yükseltme senaryoları	GSI API'lerinin kaldırıldığından haberdar değil. Oyun, en yeni kimlik doğrulama SDK'sına yükseltiliyor. Mevcut kimlik doğrulama işlevi bozulur ve SDK1, Kimlik Bilgisi Yöneticisi SDK'sını entegre etmeye zorlanır. Oyun, en yeni Auth SDK'sı ve Kimlik Bilgisi Yöneticisi SDK'sını içeren en son sürümü yayınlar.	GSI API'nin kaldırıldığının farkında olan SDK1, kimlik doğrulama SDK'sını yükseltmez ancak Google kimlik doğrulama işlevini en son sürümdeki Kimlik Bilgisi Yöneticisi SDK'sını kullanarak destekler.	SDK1, en son sürümünde Kimlik Bilgisi Yöneticisi SDK'sını kullanarak Google kimlik doğrulama işlevine güç veriyor ve kimlik doğrulama SDK'sını tamamen kaldırıyor.
Play Games Hizmetleri v1 SDK'sı	Değişmeyenler	Değişmeyenler	Değişmeyenler
Oyun derlendiğinde ne olur?	Play Games Hizmetleri v1 için ayrı bir Auth SDK entegrasyonu gerekir. Auth SDK, GSI API'leri olmadan yükseltildiğinden Play Games Hizmetleri v1 bozulur. Oyun, derleme zamanı hataları alıyor. Oyun daha sonra çözünürlük yolunu izlemeye çalışır.	Oyunda derleme zamanı hataları oluşuyor	Oyun daha sonra çözünürlük yolunu izlemeye çalışır.
Olası oyuncu deneyimi	Hiçbiri. Oyun derlenemediği için yayınlanmıyor.	Oyuncu, Play Games Hizmetleri v1 kullanılarak kimlik doğrulaması yaparken Play Games Hizmetleri hesap seçicisini görür. Oyuncu, SDK1 özelliğinde kimlik doğrulama yaparken Kimlik Bilgisi Yöneticisi alt sayfasını görür.	Oyuncu, Play Games Hizmetleri v1 kullanılarak kimlik doğrulaması yaparken Play Games Hizmetleri hesap seçicisini görür. Oyuncu, SDK1 özelliğinde kimlik doğrulama yaparken Kimlik Bilgisi Yöneticisi alt sayfasını görür.
Oyun geliştiriciler için çözüm yolu	Hangi SDK'nın kimlik doğrulama SDK'sının yükseltilmesine neden olduğunu öğrenin. SDK1'in SDK sürümünü geri alın. Oyunu, özellikleriyle birlikte yeniden derleyin. Yeni oyun özelliği için SDK1'e yükseltme yapılması gerekiyorsa SDK1 ile iletişime geçerek kendi sürümleri için 2. veya 3. senaryoyu kullanın.	Nothing Ancak Google ile oturum açma düğmesi de kullanıyorsanız oyuncular için iki tür Google ile oturum açma akışı kullanmanız gerekebilir.	Nothing Ancak Google ile oturum açma düğmesi de kullanıyorsanız oyuncular için iki tür Google ile oturum açma akışı kullanmanız gerekebilir.
Play Games Hizmetleri v1'in nihai sonucu	Oyunun Play Games Hizmetleri v2'ye yükseltilmesi gerekmiyor ancak SDK1 güncel değil.	Oyunun Play Games Hizmetleri v1'den v2'ye yükseltilmesi gerekmez.	Oyunun Play Games Hizmetleri v1'den v2'ye yükseltilmesi gerekmez.