Google Play Developer API'leri

Genel bakış

Google Play Console, yayınlama, raporlama ve diğer uygulama yönetimi işlevlerini doğrudan uygulamanız için gerçekleştirmenizi sağlayan REST tabanlı web hizmeti API'lerinden oluşan bir paket 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'nız varsa veya kullanıcı satın alma işlemlerini ve abonelikleri 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 harcarken uygulamanızı tasarlamaya ve geliştirmeye odaklanmanızı sağlar.

Google Play Console, uygulamanızı yönetmek için kullanabileceğiniz bir API paketi içerir:

  • Yayınlama API'si, uygulama yükleyip yayınlamanıza ve yayınlamayla ilgili diğer görevleri gerçekleştirmenize olanak tanır.
  • Abonelikler ve Uygulama İçi Satın Almalar API'si, uygulama içi satın alma işlemlerini ve abonelikleri yönetmenize olanak tanır. (Bu, daha önce "Satın Alma Durumu API'si" olarak biliniyordu.)
  • Reporting API, Android vitals'dan uygulamanızın kalitesi hakkında bilgi almanıza olanak tanır.
  • Reply to Reviews API, uygulamanızla ilgili yorumları almanıza ve yanıtlamanıza olanak tanır.
  • Permissions API, Play Console'daki izin yönetimini otomatikleştirmenizi sağlar.
  • Play Games Hizmetleri Yönetim API'si, Google Play Games Hizmetleri özelliklerinin altında yatan meta verileri programatik olarak kontrol etmek için REST çağrıları yayınlamanıza olanak tanır.
  • Voided Purchases API'si, kullanıcının iptal ettiği satın alma işlemleriyle ilişkili siparişlerin listesini sağlar.

Başlangıç

Google Play Developer API'lerini kullanmaya başlamak için başlangıç belgelerine bakın.

Yayınlama API'sı

Yayınlama API'si, uygulama dağıtımıyla ilgili sık tekrarlanan görevleri otomatik hale getirmenizi sağlar. Bu, geliştiricilere Play Console üzerinden sunulanlara benzer işlevler sağlar. Örneğin:

  • Bir 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, grafikler ve birden çok cihaza ait ekran görüntüleri de dahil olmak üzere Google Play Store girişi oluşturma ve değiştirme

Bu görevler, değişiklik yaparken işlemsel bir yaklaşım uygulayan düzenleme işlevi kullanılarak gerçekleştirilir. Bu sayede, birkaç değişikliği tek bir taslak düzenlemede gruplandırabilir ve değişiklikleri bir defada kaydedebilirsiniz. (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 defadan daha sık yayınlamayın (üretim uygulamaları bundan daha seyrek güncellenmelidir). Her güncelleme kullanıcılarınıza zaman ve muhtemelen para kazandırır. Çok sık güncelleme yaparsanız kullanıcılar güncellemeleri yoksaymaya başlayabilir, hatta ürünün yüklemesini kaldırabilir.

Abonelikler ve Uygulama İçi Satın Almalar API'si

Abonelikler ve Uygulama İçi Satın Almalar API'si, 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'si ile standart bir GET isteğini kullanarak herhangi bir satın alma işleminin ayrıntılarını hızla 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, tek tek siparişlerin raporlanması ve mutabakatı, satın alma işlemleri ve abonelik sürelerinin doğrulanması gibi çeşitli amaçlarla kullanabilirsiniz. API'yi iptal edilen siparişler hakkında bilgi edinmek ve uygulama içi ürünlerin iptal edilmeden önce tüketilip tüketilmediği dahil olmak üzere tüketilip tüketilmediğini doğrulamak için de kullanabilirsiniz.

En iyi uygulamalar

  • Gereksiz API çağrıları yapmamak için abonelik bilgilerini sunucunuzda depolayın. Uygulamanızın bir aboneliği doğrulaması gerektiğinde, Google'a yapılan API çağrısını tekrarlamak yerine sunucunuzdaki önbelleğe alınan bilgileri dikkate almalısınız.
  • 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 gerçek zamanlı bir geliştirici bildirimi (RTDN) alır.
  • Abonelik durumu için API'yi düzenli olarak yoklamayın. Örneğin, abonelikleri kontrol etmek için API'yi her gün çağırmayın.
  • Abonelik süresi dolduğunda veya yenilendiğinde bir RTDN aldığınız için planlanan süre sonu tarihine 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 diğer veri kümeleriyle birlikte potansiyel olarak şirket içi iş raporlaması ve analizi için Play Console verilerini kullanan geliştiriciler içindir. Böylece dahili raporlama, analiz ve otomasyon için uygulama düzeyindeki veri ve metriklere programatik erişim elde edersiniz.

Raporlama API'si kilitlenme oranı, ANR oranı, uyandırma ve uyanık kalma kilidi sorunları ile hata yığını izlemeleri dahil Android vitals verilerine erişim sunar.

En iyi uygulamalar

  • Reporting API'nin bu sürümünde varsayılan olarak saniyede 10 sorgu sınırı vardır. 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 bu formu kullanarak kota isteği gönderebilirsiniz.

Reply to Reviews API'si

Reply to Reviews API'yi kullanarak uygulamanızla ilgili kullanıcı geri bildirimlerini görüntüleyebilir ve bu geri bildirimi yanıtlayabilirsiniz. Bu API'yi, kullanıcılarla doğrudan CRM sistemi gibi mevcut müşteri desteği araç setlerinizde etkileşim kurmak için kullanabilirsiniz.

Reply to Reviews API API'yi kullanarak yalnızca uygulamanızın üretim sürümleriyle ilgili geri bildirimlere erişebilirsiniz. Uygulamanızın alfa veya beta sürümleriyle ilgili geri bildirimler görmek istiyorsanız bunun yerine 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ızı derecelendirirse ancak yorum vermezse API'den bu kullanıcının geri bildirimine erişilemez.

İzinler API'si

Permissions API, geliştiricilere Play Console'da izin yönetimini otomatikleştirme olanağı sunar. Bu sayede, manuel müdahaleye gerek olmadan geliştirici hesabınıza kimlerin erişebileceğini esnek bir şekilde kontrol edebilirsiniz.

Permissions API ile yönetimsel işlevleri gerçekleştirebilirsiniz. Örneğin:

  • Şirketinizden ayrılan kullanıcıların erişimini kaldırma.
  • Kullanıcı ilgili ekibe katıldığında uygulamaya erişim izni verme.

Voided satın alma işlemleri API'si

Voided Purchases API'si, kullanıcının iptal ettiği satın alma işlemleriyle ilişkili siparişlerin listesini sunar. Kullanıcının bu siparişlerdeki ürünlere erişmesini engelleyen bir iptal sistemi uygulamak için bu listedeki bilgileri kullanabilirsiniz.

Bu API, tek seferlik uygulama içi siparişler ve uygulama abonelikleri için geçerlidir.

Satın alma işlemleri aşağıdaki şekillerde iptal edilebilir:

  • Kullanıcı, siparişi için geri ödeme isteğinde bulunur.
  • Kullanıcı siparişini iptal eder.
  • Siparişin ödemesi iade edilir.
  • Geliştirici siparişi iptal eder veya siparişi geri öder. Not: Voided Purchases API'sinde yalnızca iptal edilen siparişler gösterilir. Geliştirici, iptal etme seçeneğini ayarlamadan geri ödeme yaparsa siparişler API'de görünmez.
  • Google siparişi iptal eder veya siparişe geri ödeme yapar.

Bu API'yi kullanarak, özellikle uygulamanız bir oyunsa uygulamanızın tüm kullanıcıları için daha dengeli ve adil bir deneyim oluşturabilirsiniz.