Geçersiz Satın Alma İşlemleri API'si

Google Play Geçersiz Satın Alma İşlemleri API'si, kullanıcının iptal ettiği satın alma işlemleriyle ilişkili siparişlerin listesini sağlar. Kullanıcının bu siparişlerdeki ürünlere erişmesini engelleyen bir iptal sistemini 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şlemi aşağıdaki şekillerde iptal edilebilir:

• Kullanıcı, siparişi için geri ödeme talebinde bulunur.
• Kullanıcı siparişini iptal eder.
• Bir siparişin ödemesi ters ibraz edilir.

• 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 bir satın alma işlemi için geri ödeme yaparsa sipariş, API tarafından iade edilmez.

• Google siparişi iptal eder veya 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.

Not: Siparişle ilgili diğer veri kaynaklarının aksine Voided Purchases API, ödeme işleyiciler tarafından geri alınan satın alma işlemlerini içerir. Bu nedenle, bu API'den alınan bilgilerle siparişle ilgili diğer veri kaynaklarından alınan bilgiler arasında tutarsızlıklar görebilirsiniz.

Not: Voided Purchases API, geçersiz satın alma işlemlerini yalnızca iptal edilmeleri gerektiğinde döndürür. Geliştiriciler bu API'yi, ne zaman ek işlem yapmaları gerektiğinin göstergesi olarak kullanabilir.

Erişim Kazanma

Voided Purchases API'si ile çalışmak için finansal bilgileri görüntüleme izninizin olması gerekir. Yetkilendirmeyi bir OAuth istemcisi veya hizmet hesabı kullanarak sağlarsınız. Hizmet hesabı kullanıyorsanız bu hesapta "Finansal raporları görüntüleme" iznini etkinleştirin.

Google Play Developer API'lerine yetkili erişim kazanma hakkında daha fazla bilgi edinmek için aşağıdaki kılavuzlara bakın:

• API Erişimi İstemcilerini Ayarlama
• Geliştirici hesabı kullanıcıları ekleme ve izinleri yönetme

İptal Edilmiş Satın Alımları Görüntüleme

İptal edilen satın alma işlemlerinin listesini istemek için GET yöntemini kullanın. İsteğinize uygulamanızın tam nitelikli paket adını (ör. com.google.android.apps.maps) ve API'ye erişim kazanırken aldığınız yetkilendirme jetonunu ekleyin.

GET https://www.googleapis.com/androidpublisher/v3/applications/
your_package_name/purchases/voidedpurchases?access_token=your_auth_token

İsteğinize, her biri isteğe bağlı olan aşağıdaki parametreleri de ekleyebilirsiniz:

startTime

Yanıtta görmek istediğiniz, geçersiz kılınan en eski satın alma işleminin Unix döneminden bu yana geçen milisaniye cinsinden süre. Varsayılan olarak startTime, 30 gün öncesine ayarlanmıştır.

API yalnızca son 30 gün içinde gerçekleşen geçersiz satın alma işlemlerini gösterebilir. İptal edilen eski satın alma işlemleri, startTime için sağladığınız değerden bağımsız olarak yanıta dahil edilmez.

Not: Yanıtta geçersiz kılınan satın alma işlemleri, belirli bir kaydın yanıtta döndürülen voidedTimeMillis değerine göre değil, API tarafından iptal edildiği zamana göre filtrelenir.

endTime

Yanıtta görmek istediğiniz, geçersiz kılınan en yeni satın alma işleminin Unix döneminden bu yana geçen milisaniye cinsinden süre. Varsayılan olarak, endTime geçerli saate ayarlıdır.

Not: Yanıtta geçersiz kılınan satın alma işlemleri, belirli bir kaydın yanıtta döndürülen voidedTimeMillis değerine göre değil, API tarafından iptal edildiği zamana göre filtrelenir.

maxResults

Her bir yanıtta görünen geçersiz satın alma işlemlerinin maksimum sayısı. Bu değer varsayılan olarak 1.000'dir. Bu parametre için maksimum değerin de 1.000 olduğunu unutmayın.

token

Daha fazla sonuç görüntülemenize olanak tanıyan önceki bir yanıtın devam jetonu.

tür

Her yanıtta görünen geçersiz satın alma işlemlerinin türü. 0 olarak ayarlanırsa yalnızca geçersiz olan uygulama içi satın alma işlemleri döndürülür. 1 olarak ayarlanırsa hem geçersiz uygulama içi satın alma işlemleri hem de geçersiz abonelik satın alma işlemleri iade edilir. Varsayılan değer 0'dır.

Not: Geçersiz abonelik satın alma işlemlerini alma isteğinde bulunmadan önce tek seferlik satın alımları ve abonelikleri benzersiz şekilde tanımlayan yanıtta orderId'ye geçiş yapmanız gerekir. Aksi takdirde, aynı PurchaseToken ile birden fazla abonelik siparişi alırsınız.

Yanıt, geçersiz satın alma işlemlerinin listesini içeren bir JSON dizesidir. maxResults istek parametresinde belirtilen sayıdan daha fazla sonuç varsa yanıt, daha fazla sonuç görüntülemek için bir sonraki isteğe iletebileceğiniz nextPageToken değerini içerir. Listedeki ilk sonuç, geçersiz kılınan en eski satın alma işlemini gösterir.

{
  "tokenPagination": {
    "nextPageToken": "next_page_token"
  },
  "voidedPurchases": [
    {
      "kind": "androidpublisher#voidedPurchase",
      "purchaseToken": "some_purchase_token",
      "purchaseTimeMillis": "1468825200000",
      "voidedTimeMillis": "1469430000000",
      "orderId": "some_order_id",
      "voidedSource": "0",
      "voidedReason": "4"
    },
    {
      "kind": "androidpublisher#voidedPurchase",
      "purchaseToken": "some_other_purchase_token",
      "purchaseTimeMillis": "1468825100000",
      "voidedTimeMillis": "1470034800000",
      "orderId": "some_other_order_id",
      "voidedSource": "2",
      "voidedReason": "5"
    },
  ]
}

Kotalar

Voided Purchases API'si, aşağıdaki kotaları paket bazında ayarlar:

• Günde 6.000 sorgu. (Gün, Pasifik Saati'ne göre gece yarısında başlar ve sona erer.)
• Herhangi bir 30 saniyelik dönemde 30 sorgu.

İlk istekler için yönergeler

İlk API isteğiniz sırasında uygulamanızın mevcut tüm verilerini getirmek isteyebilirsiniz. Düşük bir ihtimal olsa da bu işlem günlük kotanızı tüketebilir. Geçersiz satın alma verilerini daha güvenli ve tutarlı bir şekilde elde etmek için aşağıdaki en iyi uygulamaları izleyin:

• maxResults parametresi için varsayılan değeri kullanın. Bu şekilde, sorgu kotanızın tamamını bir gün için kullanırsanız 6.000.000 iptal edilen satın alma işleminin ayrıntılarını alabilirsiniz.
• Yanıtta nextPageToken için bir değer varsa bir sonraki isteğiniz sırasında bu değeri token parametresine atayın.

En iyi uygulamalar

Not: Geliştiricilerin bu API'yi kullanmanın yanı sıra Gerçek zamanlı geliştirici bildirimleri (RTDN) ile entegrasyon yapması gerekir. RTDN sayesinde, uygulamanızda bir kullanıcının yararlanma haklarında bir değişiklik olduğunda (kullanıcının satın alma işlemini iptal etmesi de dahil) Google'dan bildirim alırsınız.

Uygulamanızda bu API'yi kullanırken, bir satın alma işlemini iptal etmek için pek çok neden olduğunu ve her durumda işe yarayan tek bir çözüm olmadığını unutmayın. İptal politikalarınızı ve stratejilerinizi tasarlarken kullanıcılarınızı göz önünde bulundurmalısınız. Bunu yapmak için önerilen şu uygulamaları uygulayabilirsiniz:

• İstenmeyen davranışları ele almak için kapsamlı bir stratejinin pek çok öğesinden biri olarak bu API'yi kullanın. Uygulama içi ürünlere erişimi iptal etmek, uygulama içi satın alma işlemleri için uygun fiyatlı bir uygulama, istenmeyen davranışlardan vazgeçiren bir uygulama tasarımı, kültürü bu tür davranışları reddeden güçlü bir kullanıcı tabanı ve duyarlı ve verimli kullanıcı destek kanallarıyla birleştirildiğinde genellikle daha etkilidir.
• Tüm kullanıcılar için adaleti sağlamak amacıyla iptal politikanızı eşit şekilde yönetin.
• İstenmeyen davranışlarla başa çıkarken aşamalı bir politika oluşturun. Örneğin, erken suçlular için uygulama içi uyarılarla başlayın ve ardından kullanıcının istenmeyen davranışları devam ettikçe cevabınızı üst birime iletin. Son çare olarak, kullanıcının uygulamanızla etkileşimde bulunmasını engelleyebilirsiniz.
• Bir iptal politikasını uygulamaya koyduğunuzda ve bunu her güncellediğinizde, kullanıcılarınızı değişiklikler hakkında bilgilendirmek için uygulamanızın destek kanallarını kullanın. Bu değişiklikler uygulamanızda geçerli olmadan önce kullanıcılarınıza bu değişiklikleri net bir şekilde anlamaları için zaman tanıyın.
• Kullanıcılarınıza karşı şeffaf olun ve uygulama içi ürüne erişimlerini iptal etme gibi bir işlem gerçekleştirdiğinizde kullanıcıları bilgilendirin. İdeal olarak, kullanıcılar kararlarınıza itiraz edebilmeli ve bu tür anlaşmazlıklar adil bir şekilde ele alınmalıdır.
• Kullanıcıları istenmeyen davranışlara iten şeyin ne olduğunu ve bu tür davranışları nasıl gerçekleştirdiklerini anlamak için geri bildirim formlarını ve topluluk forumlarını izleyin. İlk savunma hattı olarak bu bilgilere göre hareket edin.