Method: purchases.voidedpurchases.list

İptal edilen, geri ödemesi yapılan veya ters ibraz uygulanan satın alma işlemlerini listeler.

HTTP isteği

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
packageName

string

Geçersiz satın alma işlemlerinin iade edilmesi gereken uygulamanın paket adı (örneğin, "com.bir.thing").

Sorgu parametreleri

Parametreler
pageSelection.maxResults

integer (uint32 format)

Liste işleminin kaç sonuç döndürmesi gerektiğini tanımlar. Varsayılan sayı, kaynak toplama işlemine bağlıdır.

pageSelection.startIndex

integer (uint32 format)

Döndürülecek ilk öğenin dizinini tanımlar. Bu, yalnızca dizine eklenmiş sayfalandırma etkinleştirilmişse kullanılabilir.

pageSelection.token

string

Döndürülecek sayfanın jetonunu tanımlar. Bu jeton genellikle TokenPagination'dan alınır. Bu yalnızca jeton sayfalama etkinleştirilmişse kullanılabilir.

startTime

string (int64 format)

Yanıtta görmek istediğiniz en eski geçersiz satın alma işleminin Dönem'den itibaren milisaniye cinsinden süresi. Bu parametrenin değeri 30 günden eski olamaz ve sayfalara ayırma jetonu ayarlanmışsa yoksayılır. Varsayılan değer, geçerli zaman eksi 30 gündür. Not: Bu filtre, yanıtta döndürülen gerçek geçersiz kılınan süreye değil, kaydın sistemlerimiz tarafından geçersiz olduğu görüldüğü zaman uygulanır.

endTime

string (int64 format)

Yanıtta görmek istediğiniz en yeni geçersiz satın alma işleminin Dönem'den itibaren milisaniye cinsinden süresi. Bu parametrenin değeri geçerli zamandan büyük olamaz ve sayfalara ayırma jetonu ayarlanırsa bu değer yoksayılır. Varsayılan değer, geçerli zamandır. Not: Bu filtre, yanıtta döndürülen gerçek geçersiz kılınan süreye değil, kaydın sistemlerimiz tarafından geçersiz olduğu görüldüğü zaman uygulanır.

type

integer

Yanıtta görmek istediğiniz geçersiz satın alma işlemlerinin türü. Olası değerler: 0. Yanıtta yalnızca geçersiz uygulama içi ürün satın alma işlemleri iade edilir. Bu, varsayılan değerdir. 1. Yanıtta hem geçersiz uygulama içi satın alma işlemleri hem de geçersiz abonelik satın alma işlemleri iade edilir.

Not: Geçersiz abonelik satın alma işlemlerini alma isteğinde bulunmadan önce, yanıtta tek seferlik satın alma işlemlerini ve abonelikleri benzersiz şekilde tanımlayan orderId kullanmanız gerekir. Aksi takdirde, abonelik yenileme siparişleri aynı PurchaseToken'ı paylaştığından aynı PurchaseToken'a sahip birden fazla abonelik siparişi alırsınız.

includeQuantityBasedPartialRefund

boolean

İsteğe bağlı. Yalnızca çoklu miktar satın alma işlemleri için geçerli olan, miktara dayalı kısmi geri ödemeler geçersiz satın alma işlemlerinin dahil edilip edilmeyeceğini belirler. Doğru olması halinde, ek geçersiz satın alma işlemleri, miktara dayalı kısmi geri ödemenin geri ödeme miktarını belirten voidedquantity ile iade edilebilir. Varsayılan değer false'tur.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

voidedpurchases.list API ile ilgili yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
Alanlar
pageInfo

object (PageInfo)

Sayfalara ayırmayla ilgili genel bilgiler.

tokenPagination

object (TokenPagination)

Jetonları sayfalandırmak için sayfalara ayırma bilgileri.

voidedPurchases[]

object (VoidedPurchase)

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/androidpublisher

PageSelection

Bir voidedpurchases.list işleminin hangi sonucu döndürmesi gerektiğini ve kaç sonuç döndürmesi gerektiğini tanımlayan pageSelection istek parametresinin türü.

JSON gösterimi
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
Alanlar
maxResults

integer (uint32 format)

Liste işleminin kaç sonuç döndürmesi gerektiğini tanımlar. Varsayılan sayı, kaynak toplama işlemine bağlıdır.

startIndex

integer (uint32 format)

Döndürülecek ilk öğenin dizinini tanımlar. Bu, yalnızca dizine eklenmiş sayfalandırma etkinleştirilmişse kullanılabilir.

token

string

Döndürülecek sayfanın jetonunu tanımlar. Bu jeton genellikle TokenPagination'dan alınır. Bu yalnızca jeton sayfalama etkinleştirilmişse kullanılabilir.