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.some.thing").

Sorgu parametreleri

Parametreler
pageSelection.maxResults

integer (uint32 format)

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

pageSelection.startIndex

integer (uint32 format)

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

pageSelection.token

string

Döndürülecek sayfanın jetonunu tanımlar, genellikle TokenPagulation'dan alınır. Bu, yalnızca jeton sayfalandırması etkinse kullanılabilir.

startTime

string (int64 format)

Yanıtta görmek istediğiniz, geçersiz kılınan en eski satın alma işleminin Epoch'tan beri geçen milisaniye cinsinden süresi. Bu parametrenin değeri 30 günden eski olamaz ve sayfalandırma jetonu ayarlanırsa yoksayılır. Varsayılan değer, geçerli süre eksi 30 gündür. Not: Bu filtre, yanıtta döndürülen asıl geçersiz kılınma zamanına değil, kaydın sistemlerimiz tarafından geçersiz kılındığı algılanan zamana uygulanır.

endTime

string (int64 format)

Yanıtta görmek istediğiniz, geçersiz kılınan en yeni satın alma işleminin Dönemi'nden bu yana geçen milisaniye cinsinden süre. Bu parametrenin değeri, geçerli zamandan büyük olamaz ve sayfalandırma jetonu ayarlanırsa yoksayılır. Varsayılan değer geçerli saattir. Not: Bu filtre, yanıtta döndürülen asıl geçersiz kılınma zamanına değil, kaydın sistemlerimiz tarafından geçersiz kılındığı algılanan zamana uygulanır.

type

integer

Yanıtta görmek istediğiniz geçersiz satın alma işlemi türüdü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: İptal edilen abonelik satın alma işlemlerini almayı istemeden önce, yanıtta tek seferlik satın almaları ve abonelikleri benzersiz şekilde tanımlayan orderId'yi kullanmaya geçmeniz gerekir. Aksi takdirde, abonelik yenileme siparişleri aynı PurchaseToken'i paylaştığından aynı PurchaseToken'a sahip birden fazla abonelik siparişi alırsınız.

includeQuantityBasedPartialRefund

boolean

İsteğe bağlı. Yalnızca çok miktarlı satın alma işlemleri için geçerli olan miktara dayalı kısmi geri ödemelerin geçersiz satın alma işlemlerinin dahil edilip edilmeyeceğini belirtir. "True" (doğru) değerine ayarlanırsa, geçersiz kılınan ek satın alma işlemleri, miktara dayalı kısmi geri ödemenin geri ödeme miktarını belirten voidedquantity özelliğiyle iade edilebilir. Varsayılan değer, false (yanlış) değeridir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

voidedpurchases.list API'sinin 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ı sayfalara ayı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 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üreceğini tanımlar. Varsayılan sayı, kaynak koleksiyonuna bağlıdır.

startIndex

integer (uint32 format)

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

token

string

Döndürülecek sayfanın jetonunu tanımlar, genellikle TokenPagulation'dan alınır. Bu, yalnızca jeton sayfalandırması etkinse kullanılabilir.