Google Play kurulumu

Refund Sensor, kendi Google Cloud projenizde oluşturduğunuz bir hizmet hesabıyla Google Play'e bağlanır. Hiç sona ermez ve yeniden yetkilendirme gerektirmez. Şunlara ihtiyacınız olacak:

• Play Console'unuzun sahibi olan hesapta bir Google Cloud projesi (ücretsizi de olur).
• İndirebileceğiniz bir JSON anahtarı olan bir hizmet hesabı.
• O hesaba verilmiş Play Console erişimi ve Pub/Sub Admin.
• Savunmak istediğiniz paket adları veya Play Store URL'leri.

1. Play Console'unuzun sahibi olan hesapla Google Cloud Console'u açın ve bir proje seçin ya da oluşturun. Sol menüde IAM & Admin'i açın ve Service accounts'a tıklayın.
2. + Create service account'a tıklayın, RefundSensor Google Play API gibi bir ad verin, ardından Create and continue ve Done'a tıklayın. İsteğe bağlı rolleri burada atlayabilirsiniz.
3. Hizmet hesabı e-postasını kopyalayın (.iam.gserviceaccount.com ile biter). Sonraki adımlarda gerekecek.
4. Hizmet hesabını açın, Keys sekmesine geçin, Add key → Create new key'e tıklayın, JSON seçin ve Create'e tıklayın. Google bir .json dosyası indirir. Güvende tutun; Google onu tekrar indirmenize izin vermez.

Projenizin iki Google API'sinin etkinleştirilmesi gerekir (proje başına tek seferlik bir adım). Google Cloud Console'da projeniz seçiliyken her birini arayıp etkinleştirin:

• Google Play Android Developer API, hizmet hesabının iade ve sipariş verilerinizi okumasını sağlar.
• Cloud Pub/Sub API, gerçek zamanlı iade bildirimlerini çalıştırır. Farklı bir ürün olan Pub/Sub Lite değil, Cloud Pub/Sub olduğundan emin olun.

Refund Sensor'da Add app'i açın, Google Play'i seçin ve .json anahtar dosyasını yükleyin. Onu Google ile doğrular ve AES-256-GCM ile beklemede şifreleyerek saklarız.

Hizmet hesabını Play Console'a davet edin ve iki yerde finansal erişim verin; çünkü iade (iptal edilen satın alma) verisi hesap düzeyinde okunur:

1. Google Play Console'da Users and permissions → Invite new users'u açın ve hizmet hesabı e-postasını yapıştırın. Bir hizmet hesabı siz kaydeder kaydetmez etkinleşir; daveti kendisi kabul etmez.
2. App permissions altında, savunmak istediğiniz her uygulamayı ekleyin ve View financial data ile Manage orders and subscriptions'ı açın.
3. Account permissions sekmesine geçin (kaçırması kolay) ve Financial data altında View financial data, orders and cancellation survey responses ile Manage orders and subscriptions'ı açıp kaydedin.

Gerçek zamanlı bildirimler, sizin için oluşturup bağladığımız bir Pub/Sub konusu üzerinden Refund Sensor'a ulaşır, bu yüzden Play Console'a yapıştırılacak bir şey yoktur. Yalnızca Pub/Sub'ı yönetme iznine ihtiyacı vardır. IAM & Admin → IAM'de Grant access'e tıklayın, hizmet hesabı e-postanızı principal olarak yapıştırın, Pub/Sub Admin (roles/pubsub.admin) rolünü seçin ve kaydedin. Pub/Sub Lite Admin değil, Pub/Sub Admin seçin; Lite rolü çalışmaz ve otomatik kurulumun başarısız olmasının en yaygın nedenidir.

Add apps adımında, her satıra bir Play Store URL'si veya paket adı yapıştırın (paket adı, bir Play Store bağlantısında ?id='den sonraki değerdir, örneğin com.yourcompany.app). Refund Sensor içe aktarmadan önce her birini bağlı hesabın Play Console erişimine göre doğrular ve göremediklerini işaretler.

API'ler etkin ve Pub/Sub Admin verilmişken bir uygulamayı içe aktarmak, konuyu ve push aboneliğini otomatik oluşturur ve onu uygulamanın RTDN uç noktası olarak kaydeder. Ardından uygulama, Google ilk gerçek olayı iletene kadar Awaiting first refund event gösterir (Google tarafında test düğmesi yoktur). Otomatik kurulum bir gün başarısız olursa, uygulama kartı bu kılavuza geri dönen bir bağlantıyla birlikte Real-time notifications not set up gösterir.

Her Google Play iadesine itiraz edilemez. Sıradan bir kullanıcı iadesine Google kendisi karar verir, bu yüzden bunlar görünürlük için kaydedilir ama itiraz edilmez.

Gerçekten yanıtlayabileceğiniz tek iade, incelemedeki bir ters ibraztır (Google'ın pendingRefundReviewNotification'ı). Size yaklaşık 24 saat verir ve ilk yanıtı dikkate alır. Refund Sensor buna bir ret önerisiyle otomatik yanıt verir, pencerenin epey içinde.

Bir emniyet olarak Refund Sensor, Google'ın Voided Purchases API'siyle de mutabakat yapar; böylece itiraz edilecek bir şey olmadığında bile her iade ve iptal edilen satın alma panelinize kaydedilir.