API çağrıları yapmaya başlamadan önce Google Play geliştirici hesabınıza API erişimini ayarlamanız gerekir. Bu işlem, hem Google Play Console'da hem de Google Cloud Console'da değişiklik yapılmasını gerektirir. Aşağıdaki talimatlarda, Google Play Developer API'yi kullanmaya başlamak için gereken adımlar açıklanmaktadır.
- Google Cloud projesi oluşturun.
- Google Cloud projeniz için Google Play Developer API'yi etkinleştirin.
- Google Play Developer API'ye erişmek için uygun Google Play Console izinlerine sahip bir hizmet hesabı oluşturun.
Google Cloud projesi oluşturma
Kullanmak istediğiniz bir Google Cloud projeniz varsa bu adımı atlayabilirsiniz.
Google Cloud Console'da proje oluşturun.
Google Cloud projeleri hakkında daha fazla bilgi için Proje oluşturma ve yönetme başlıklı makaleyi inceleyin.
API'yi etkinleştirme
Google Cloud projesini oluşturduktan sonra bu proje için Google Play Developer API'yi etkinleştirmeniz gerekir.
Google Play Developer API'yi etkinleştirmek için:
- Google Cloud Console'da Google Play Developer API sayfasına gidin.
- Etkinleştir'i tıklayın.
OAuth ve hizmet hesaplarını yapılandırma
Google Play Developer API'ye erişimi bir OAuth istemcisi veya hizmet hesabı ile yapılandırmanız gerekir. Çoğu durumda, API'ye erişmek için bir hizmet hesabı kullanmanız gerekir.
Hizmet hesapları, sunucunuz gibi güvenli bir ortamda kullanılmalıdır. Hizmet hesabı kimlik bilgilerinin, API'yi kullanmaya yetkili olmayan kişilere açıklanmaması için güvenli bir şekilde yönetilmesi gerekir.
API'ye tek bir kullanıcı adına erişmeniz gerekiyorsa OAuth istemci kimliği kullanılmalıdır. Örneğin, web sitenizin kullanıcı adına web istemcisinden Google Play Developer API'ye erişmesi gerekiyorsa istemci kimliğini kullanabilirsiniz. Kullanıcının kimliği, hizmet hesabı yerine Google Hesabı ile doğrulanır. Bu sayede, hizmet hesabı kimlik bilgilerinden ödün vermeden kullanıcı adına API çağrıları yapabilirsiniz.
- Hizmet hesabı: Güvenli bir yazılım hizmeti API'ye erişir (en yaygın yöntem).
- OAuth istemcileri: Kullanıcı API'ye erişir
Hizmet hesabı kullanma
Google Play Console'dan hizmet hesabı oluşturabilirsiniz.
- Google Cloud Console'da Hizmet Hesapları'na gidin.
- Hizmet hesabı oluştur'u tıklayın ve adımları uygulayın.
- Google Play Console'da Kullanıcılar ve İzinler sayfasına gidin.
- Yeni kullanıcı davet et'i tıklayın.
Hizmet hesabınızın e-posta adresini e-posta adresi alanına girin ve işlemleri gerçekleştirmek için gerekli hakları verin.
Google Play Billing API'lerini kullanmak için aşağıdaki izinleri vermeniz gerekir:
- Finansal verileri, siparişleri ve iptal anketine verilen yanıtları görüntüleme
- Siparişleri ve abonelikleri yönetme
Kullanıcı davet et'i tıklayın.
Bu noktada, hizmet hesabı üzerinden Google Play Developer API'ye erişebilmeniz gerekir. Daha fazla bilgi için Sunucudan Sunucuya Uygulamalar için OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.
OAuth istemcilerini kullanma
Kullanıcıların OAuth istemcisi kullanarak kendi kimlik bilgileriyle API'yi kullanarak işlem yapmasına izin verebilirsiniz. Kullanıcıların işlemleri, Google Play Console'daki Kullanıcılar ve izinler sayfasında izin verilen işlemlerle sınırlıdır.
OAuth istemcileri oluşturmadan önce ürününüz için marka bilgilerini yapılandırmanız gerekir. Daha fazla bilgi için OAuth kullanıcı rızası ekranınızı ayarlama başlıklı makaleyi inceleyin.
- Google Cloud Console'da OAuth kullanıcı rızası ekranı sayfasına gidin.
- OAuth izin ekranı oluşturmak için adımları uygulayın.
OAuth istemcisi oluşturmak için:
- Google Cloud Console'da Kimlik Bilgileri'ne gidin.
- Kimlik bilgileri oluştur > OAuth istemci kimliği'ni tıklayın.
- Başvuru türünüzü seçin ve talimatları uygulayın.
Ek bilgiler
Google Play'de API kullanımına başlamanıza yardımcı olacak aşağıdaki ipuçlarından ve püf noktalarından yararlanın.
Geliştirici kimliğinizi edinme
Bazı API'ler için Google Play Console geliştirici kimliği sağlamanız gerekir. Bu, Google Play Geliştirici Hesabınız oluşturulurken atanan uzun bir sayıdır. Geliştirici kimliğinizi, Google Play Console'daki neredeyse tüm sayfaların URL'sinde (ör. API erişimi sayfası) bulabilirsiniz.
Örneğin, Google Play Console URL'sini ele alalım:
https://play.google.com/console/developers/1234567890123456789/api-access
Yukarıdaki URL'de geliştirici kimliği 1234567890123456789 olur.
Not: Bir uygulama bir Google Play Geliştirici Hesabı'ndan diğerine aktarılırsa bu uygulamayla ilişkili geliştirici kimliği değişir. Bu, aktarım tamamlandıktan sonra söz konusu uygulamanın API çağrılarında yeni Google Play Geliştirici Hesabı hesabının geliştirici kimliğini kullanmanız gerektiği anlamına gelir.
Özel API'ler
Google Play Developer API, uygulamanızda belirli analiz türlerini gerçekleştirmenize olanak tanıyan çeşitli özel API'ler içerir:
- Reply to Reviews API
- Uygulamanızla ilgili kullanıcı geri bildirimlerini görüntülemenize ve bu geri bildirimlere yanıt vermenize olanak tanır.
- Voided Purchases API
- Kullanıcının iptal ettiği satın alımlarla ilişkili uygulama içi ürünlere erişimi iptal etmenize olanak tanır.
İstemci kitaplıkları
REST API'lere programatik olarak erişmek için kullanabileceğiniz istemci kitaplıkları sağladık. Daha fazla bilgi için İstemci Kitaplıkları ve Kod Örnekleri başlıklı makaleyi inceleyin.