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

Google Play Geçersiz Satın Alma İşlemleri API'si, Kullanıcının geçersiz olduğu satın alma işlemleriyle ilişkilidir. Bilgileri kullanarak devre dışı bırakmasını engelleyen bir iptal sistemi uygulamak için bu siparişlerdeki ürünlere erişmek.

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 isteğinde bulunur.
  • Kullanıcı siparişini iptal eder.
  • Bir siparişin ödemesi geri alınır.

  • Geliştirici siparişi iptal eder veya sipariş için geri ödeme yapar.

  • Google siparişi iptal eder veya geri ödeme yapar.

Bu API'yi kullanarak herkes için daha dengeli ve adil bir deneyim oluşturmaya yardımcı olursunuz. özellikle de uygulamanız bir oyunsa,

Erişim Kazanma

Voided Purchases API'si ile çalışmak için görüntüleme izninizin olması gerekir finansal bilgiler. Yetkilendirme sağlamak için bir OAuth istemcisi veya hizmet hesabı. Bir hizmet hesabı kullanıyorsanız "Finansal hesapları görüntüle" rapor" bu hesapta oturum açma izni vermiş olursunuz.

Google Play Developer API'lerine yetki verilmiş erişim kazanma hakkında daha fazla bilgi için bkz. şu kılavuzlardan yararlanabilirsiniz:

Geçersiz Satın Almaları Görüntüleme

Geçersiz satın alma işlemlerinin listesini istemek için GET yöntemini kullanın. İsteğinizde, uygulamanızın tam paket adını içermelidir (örneğin, com.google.android.apps.maps ve sizin için geçerli olan yetkilendirme jetonu (API'ye erişim elde ederken) alınan veriler.

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

Ayrıca isteğinize aşağıdaki parametreleri de ekleyebilirsiniz. Bunların her biri isteğe bağlı:

startTime

Unix dönemi'nden bu yana geçen en eski süre (milisaniye cinsinden) yanıtta görmek istediğiniz geçersiz bir satın alma işlemi gerçekleştirin. Varsayılan olarak startTime, 30 gün önce olarak ayarlandı.

API yalnızca geçmişte yapılan geçersiz satın alma işlemlerini gösterebilir 30 gün. Önceki geçersiz satın alma işlemleri, yanıta dahil edilmez. startTime için sağladığınız değerin aynısı.

endTime

Unix Epoch'tan bu yana geçen süre (milisaniye cinsinden) yanıtta görmek istediğiniz geçersiz bir satın alma işlemi gerçekleştirmiş olmanız gerekir. Varsayılan olarak endTime geçerli saate ayarlandı.

maxResults
Her yanıtta görünen maksimum geçersiz satın alma sayısı. Ölçüt bu değer 1000'dir. Bu parametre için maksimum değerin şu olduğunu unutmayın: unutmayın.
token
Önceki bir yanıttan alınan devamlılık jetonu ile daha fazla bilgi görüntüleyin sonuç.
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 uygulama içi satın alma işlemleri iade edilir. 1 olarak ayarlanırsa her ikisi de geçersiz uygulama içi satın alınan içerikler ve geçersiz abonelik satın alma işlemleri iade edilir. Varsayılan değer: 0

includeQuantityBasedPartialRefund

Miktara dayalı kısmi geri ödemeler geçersiz satın alma işlemlerinin dahil edilip edilmediği, Yalnızca çoklu miktar satın alma işlemleri için geçerlidir. true ise geçersiz satın alma işlemleri daha voidedQuantity ile iade edilebilir gösteren bir değer içerir. İlgili içeriği oluşturmak için kullanılan false varsayılan değerdir.

Yanıt, geçersiz satın alma işlemlerinin listesini içeren bir JSON dizesidir. Varsa maxResults istek parametresinde belirtilen sayıdan daha fazla sonuç. içeriyorsa yanıt bir nextPageToken değeri içerir. Bu değeri daha fazla sonuç görüntüleyebilirsiniz. Listedeki ilk sonuç, geçersiz olan en eski satın alma işlemi.

{
  "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, aşağıdaki kotaları paket başına ayarlar:

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

İlk isteklerle ilgili yönergeler

İlk API isteğiniz sırasında, projenize ilişkin mevcut tüm verileri en iyi şekilde yararlanabilirsiniz. Olası olmasa da bu işlem günlük kotanızı tüketebilir. Alıcı: Geçersiz satın alma verilerini daha güvenli ve tutarlı bir şekilde almak istiyorsanız aşağıdaki en iyi uygulamalar:

  • 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'un Geçersiz satın alma işlemleri.
  • Bir yanıt nextPageToken için bir değer içeriyorsa bu değeri token parametresini kullanın.

En İyi Uygulamalar

Uygulamanızda bu API'yi kullanırken, için bir satın alma işlemini geçersiz kılmanın ve işe yarayan tek bir çözümün olmamasını tüm durumlarda geçerlidir. İptalinizi tasarlarken kullanıcılarınızı göz önünde bulundurmalısınız politika ve stratejileri. Bunun için aşağıdaki önerilen uygulamalardan yararlanabilirsiniz:

  • Ele almak için bu API'yi, kapsamlı bir stratejinin birçok unsurundan biri olarak kullanın. istenmeyen davranışlar olabilir. Uygulama içi ürünlere erişimi iptal etmek genellikle daha etkilidir. uygulama içi satın alma işlemleri için makul fiyatlara sahip bir uygulamayla birleştirildiğinde, istenmeyen davranışlardan vazgeçirmeye çalışan uygulama tasarımı, kültür böyle davranışları reddettiği için duyarlı ve verimli bir kullanıcı desteği kanallar.
  • Tüm kullanıcılar için adil olmasını sağlamak amacıyla iptal politikanızı eşit şekilde yönetin.
  • İstenmeyen davranışları ele alırken aşamalı bir politika oluşturmayı düşünün. Örneğin, Örneğin, erken saldırılar için uygulama içi uyarılarla başlayın, ardından saldırı istenmeyen davranışı devam ettiğinde yanıt verebilir. Son çare olarak, Kullanıcının uygulamanızla hiç etkileşim kurmasını engelleme.
  • Bir iptal politikası hazırlarken ve her güncellediğinizde değişiklikler konusunda bilgilendirilmek için uygulamanızın destek kanallarının tümünden yararlanabilirsiniz. Kullanıcılarınıza bu değişiklikleri uygulamanızda geçerli hale getirmeden önce net bir şekilde anlamak için zaman ayırmanızı öneririz.
  • Kullanıcılarınıza karşı şeffaf olun ve şu gibi işlemler her gerçekleştirdiğinizde kullanıcıları bilgilendirin: uygulama içi ürüne erişimlerini iptal edebilir. İdeal olarak, kullanıcılar ve bu tür anlaşmazlıkların adil şekilde ele alınması gerekir.
  • Kullanıcıları geri bildirim formlarını ve topluluk forumlarını izleyerek istenmeyen davranışlarda bulunma ve bu tür davranışlarda bulunma. Bunlarla ilgili işlem yapın ilk savunma hattı olarak bu bilgiye ulaşabilirsiniz.