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.

  Not: Voided Purchases API'sinde yalnızca iptal edilen siparişler gösterilir. Bir geliştirici, iptal etme seçeneğini ayarlamadan bir satın alma işlemi için geri ödeme yaparsa siparişin API tarafından geri döndürülmeyeceğini unutmayın.

• 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,

Not: Siparişle ilgili diğer veri kaynaklarının aksine, Voided Purchases API'si ödeme işleyiciler tarafından geri ödeme alınan satın alma işlemlerini kapsar. Dolayısıyla, bu API'dan alınan bilgiler ile bu API'dan alınan bilgiler arasında tutarsızlıklar siparişle ilgili diğer veri kaynaklarından alınan bilgiler.

Not: Voided Purchases API, geçersiz satın alma işlemlerini yalnızca gerektiğinde iade eder. iptal edilir. Geliştiriciler bu API'yi, uygulama incelemelerinize kıyasla ne zaman kendi taraflarında yeni bir işlem yapması gerekir. Ancak bazı satın alma işlemleri için geri ödeme yapılabilir (satın alma işleminin geliştirici tarafından hiçbir zaman kabul edilmemiş olması ve bu nedenle geliştiricinin kayıtlarında yer almayabilir.

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:

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

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ı.

Not: Yanıttaki geçersiz satın alma işlemleri şu ölçütlere göre filtrelenir: belirli bir kaydın geçersiz kılındığı anlamına geldiği zaman yanıtta döndürülen voidedTimeMillis değeri.

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ı.

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

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

Not: Geçersiz kılma isteğinde bulunmadan önce kullanıyorsanız, yanıtta "orderId"yi kullanmak için tek seferlik satın alımları ve abonelikleri benzersiz bir şekilde tanımlar. Aksi takdirde Aynı PurchaseToken ile birden fazla abonelik siparişi almalıdır.

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.

Not: Bu örneğin kalan toplam miktarı, geri ödeme yapılırsa, ilgili geçersiz satın alma işleminde voidedQuantity, satın alma işleminin yapıldığına dair bir sinyaldir. Tamamen geri ödendi. Örneğin, 10 tutarındaki bir satın alma işlemi için 3 geri ödeme yapılırsa 2, 3 ve 5 miktarlarda 3 satın alma işlemi iptal edilecektir. İlk geçersiz iki satın alma işleminde voidedQuantity 2 ve 3, üçüncü geçersiz satın alma işleminde voidedQuantity yer almaz.

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

Not: Geliştiriciler, bu API'yi kullanmanın yanı sıra Google Analytics 4 ile Gerçek zamanlı geliştirici bildirimleri (RTDN). RTDN ile, bir sorun olduğunda Google'dan bildirim alırsınız Kullanıcının uygulamadaki yararlanma hakkındaki değişiklik (kullanıcının satın alma işleminin geçersiz olması.

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.