Genel Bakış
Google Play Console, doğrudan uygulamanız için yayınlama, raporlama ve diğer uygulama yönetimi işlevlerini gerçekleştirmenize olanak tanıyan REST tabanlı web hizmeti API'leri sunar.
Tüm geliştiricilerin bu geliştirici API'lerini kullanması gerekmez. Çoğu durumda uygulamalarınızı doğrudan Google Play Console'u kullanarak yönetmeye devam edebilirsiniz. Ancak yönetmeniz gereken çok sayıda APK varsa veya kullanıcı satın alma işlemlerini ve aboneliklerini izlemeniz gerekiyorsa bu API'leri faydalı bulabilirsiniz.
Sunulan avantajlar
Google Play Developer API'leri, yeni pazarlara açılırken bile sürümlerinizi yönetmek için daha az zaman ve çaba harcayarak uygulamanızı tasarlamaya ve geliştirmeye odaklanmanıza olanak tanır.
Google Play Console, uygulamanızı yönetmek için kullanabileceğiniz bir dizi API içerir:
- Publishing API, uygulamaları yükleyip yayınlamanıza ve yayınlamayla ilgili diğer görevleri gerçekleştirmenize olanak tanır.
- Subscriptions and In-App Purchases API, uygulama içi satın alma işlemlerini ve abonelikleri yönetmenize olanak tanır. (Bu API daha önce "Purchase Status API" olarak biliniyordu.)
- Reporting API, uygulamanızın kalitesiyle ilgili bilgileri Android vitals'dan almanıza olanak tanır.
- Reply to Reviews API, uygulamanızla ilgili yorumları almanıza ve yanıtlamanıza olanak tanır.
- Permissions API, Google Play Console'da izin yönetimini otomatikleştirmenize olanak tanır.
- Play Games Services Management API, Google Play Games Hizmetleri özelliklerinin temelini oluşturan meta verileri programatik olarak kontrol etmek için REST çağrıları yapmanıza olanak tanır.
- Voided Purchases API, bir kullanıcının iptal ettiği satın alma işlemleriyle ilişkili siparişlerin listesini sağlar.
Başlarken
Google Play Developer API'lerini kullanmaya başlamak için başlangıç dokümanlarına bakın.
Publishing API
Publishing API, uygulama dağıtımıyla ilgili sık tekrarlanan görevleri otomatik hale getirmenize olanak tanır. Bu API, geliştiricilerin Play Console'da kullanabileceği aşağıdaki gibi işlevler sunar:
- Uygulamanın yeni sürümlerini yükleme
- APK'ları çeşitli kanallara (alfa, beta, aşamalı sunum veya üretim) atayarak uygulamaları yayınlama
- Yerelleştirilmiş metin ve grafikler ile çoklu cihaz ekran görüntüleri de dahil olmak üzere Google Play Store girişlerini oluşturma ve değiştirme
Bu görevler, değişiklik yapmak için işlemsel bir yaklaşım benimseyen düzenlemeler işlevi kullanılarak gerçekleştirilir. Bu sayede, birden fazla değişikliği tek bir taslak düzenlemede birleştirebilir ve ardından tüm değişiklikleri tek seferde uygulayabilirsiniz. (Düzenleme onaylanana kadar değişikliklerin hiçbiri geçerli olmaz.)
En iyi uygulamalar
- Uygulama güncellemelerinin sayısını sınırlayın. Alfa veya beta güncellemelerini günde bir kereden daha sık yayınlamayın (üretim uygulamaları bundan daha seyrek güncellenmelidir). Her güncelleme, kullanıcılarınızın zamanını ve muhtemelen parasını alır. Çok sık güncelleme yaparsanız kullanıcılar güncellemeleri yok saymaya başlayabilir, hatta ürünü kaldırabilir.
Subscriptions and In-App Purchases API
Subscriptions and In-App Purchases API, uygulamanızın uygulama içi ürün ve abonelik kataloğunu yönetmenize olanak tanır. Ayrıca Subscriptions and In-App Purchases API ile standart bir GET isteği kullanarak herhangi bir satın alma işleminin ayrıntılarını hızlıca alabilirsiniz.
İstekte, satın alma işlemiyle ilgili bilgileri (uygulama paketi adı, satın alma veya abonelik kimliği ve satın alma jetonu) sağlarsınız. Sunucu, ilişkili satın alma ayrıntılarını, sipariş durumunu, geliştirici yükünü ve diğer bilgileri açıklayan bir JSON nesnesiyle yanıt verir.
Bu API'yi çeşitli şekillerde kullanabilirsiniz. Örneğin:
- Siparişleri tek tek raporlama ve mutabakat sağlama
- Satın alma işlemlerini ve aboneliklerin sona erme tarihlerini doğrulama
- İptal edilen siparişler hakkında bilgi edinme ve uygulama içi ürünlerin tüketilip tüketilmediğini (iptal edilmeden önce tüketilip tüketilmediği dahil) onaylama.
En iyi uygulamalar
- Gereksiz API çağrıları yapmamak için abonelik bilgilerini sunucunuzda saklayın. Uygulamanızın bir aboneliği doğrulaması gerektiğinde Google'a API çağrısını tekrarlamak yerine sunucunuzdaki önbelleğe alınmış bilgileri kullanmanız gerekir.
- Güvenli sunucunuzun abonelik bilgilerini almak için Google Play Developer API'yi kullanması gereken iki senaryo vardır:
- Sunucunuz daha önce görülmemiş yeni bir satın alma jetonu alır.
- Sunucunuz, yeni abonelik bilgilerini almak için satın alma jetonunu kullanmanız gerektiğini belirten bir gerçek zamanlı geliştirici bildirimi (RTDN) alır.
- Abonelik durumu için API'yi düzenli olarak yoklamayın. Örneğin, her aboneliği kontrol etmek için API'yi her gün çağırmayın.
- Abonelik sona erdiğinde veya yenilendiğinde RTDN aldığınız için planlanan süre sonuna göre bir API çağrısı planlamanız gerekmez.
Reporting API
Reporting API, Play Console verileri üzerinde otomatik iş akışları oluşturmak isteyen geliştiriciler veya Play Console verilerini dahili iş raporlama ve analizleri için (potansiyel olarak diğer veri kümeleriyle birlikte) kullanan geliştiriciler içindir. Bu sayede dahili raporlama, analiz ve otomasyona yönelik uygulama düzeyi veri ve metriklere programatik erişim elde edersiniz.
Reporting API; kilitlenme oranı, ANR oranı, uyandırma ve uyanık kalma kilidi sorunları ile hata yığın izlemeleri (stack trace) dahil olmak üzere Android vitals verilerine erişim sağlar.
En iyi uygulamalar
- Reporting API'nin bu sürümünde varsayılan sınır, saniyede 10 sorgudur. Kota kullanımınızı Google Cloud Console'un Kotalar bölümünde görüntüleyebilirsiniz. Bu sınırı aşmanız gerekiyorsa Google Play Developer Reporting API kota istek formunu kullanarak istek gönderin.
Reply to Reviews API
Reply to Reviews API, uygulamanızla ilgili kullanıcı geri bildirimlerini görüntülemenize ve bu geri bildirimleri yanıtlamanıza olanak tanır. Bu API'yi, mevcut müşteri destek araç setiniz (ör. CRM sistemi) üzerinden kullanıcılarla doğrudan etkileşim kurmak için kullanabilirsiniz.
Reply to Reviews API, yalnızca uygulamanızın üretim sürümleriyle ilgili geri bildirimlere erişmenize olanak tanır. Uygulamanızın alfa veya beta sürümleriyle ilgili geri bildirimleri görmek istiyorsanız Google Play Console'u kullanın. Ayrıca API'nin yalnızca yorum içeren yorumları gösterdiğini unutmayın. Bir kullanıcı uygulamanıza puan verir ancak yorum yapmazsa geri bildirimine API'den erişilemez.
Permissions API
Permissions API, geliştiricilere Play Console'da izin yönetimini otomatikleştirme olanağı sunar. Bu sayede, manuel müdahale olmadan geliştirici hesabınıza kimlerin erişebileceğini esnek bir şekilde kontrol edebilirsiniz.
Permissions API ile aşağıdaki gibi yönetim işlevlerini gerçekleştirebilirsiniz:
- Şirketinizden ayrılan kullanıcıların erişimini kaldırma
- Kullanıcı ilgili ekibe katıldığında bir uygulamaya erişim izni verme.
Voided purchases API
Voided Purchases API, bir kullanıcının geçersiz kıldığı satın alma işlemleriyle ilişkili siparişlerin listesini sağlar. Bu listedeki bilgileri kullanarak, kullanıcının bu siparişlerdeki ürünlere erişmesini engelleyen bir iptal sistemi uygulayabilirsiniz.
Bu API, tek seferlik uygulama içi siparişler ve uygulama abonelikleri için geçerlidir.
Bir satın alma işlemi aşağıdaki şekillerde geçersiz kılınabilir:
- Kullanıcı, siparişi için geri ödeme talep ediyor.
- Kullanıcı siparişini iptal ederse
- Bir sipariş için ters ibraz yapıldığında
- Geliştirici siparişi iptal eder veya geri ödeme yapar. Not: Voided Purchases API'de yalnızca iptal edilen siparişler gösterilir. Geliştirici, iptal seçeneğini ayarlamadan geri ödeme yaparsa siparişler API'de gösterilmez.
- Google, siparişi iptal eder veya geri ödeme yapar.
Bu API'yi kullanarak uygulamanızın tüm kullanıcıları için daha dengeli ve adil bir deneyim oluşturabilirsiniz. Bu, özellikle uygulamanız bir oyunsa önemlidir.