Method: purchases.voidedpurchases.list

İptal edilen, geri ödenen veya ters ibraz edilen 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

İptal edilen satın alma işlemlerinin iade edilmesi gereken uygulamanın paket adı (örneğin, "com.bir.şey").

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 dizin numarasını tanımlar. Bu seçenek yalnızca dizine eklenen sayfalama etkinse kullanılabilir.

pageSelection.token

string

Döndürülecek sayfanın jetonunu tanımlar (genellikle TokenPagination'den 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 iptal edilen satın alma işleminin, sıfır zamandan itibaren milisaniye cinsinden zamanı. Bu parametrenin değeri 30 günden eski olamaz ve bir sayfalandırma jetonu ayarlanmışsa yok sayılır. Varsayılan değer, geçerli zamandan 30 gün çıkarılarak hesaplanır. Not: Bu filtre, yanıtta döndürülen gerçek geçersiz kılma zamanı değil, kaydın sistemlerimiz tarafından geçersiz kıldığı görülen zamana uygulanır.

endTime

string (int64 format)

Yanıtta görmek istediğiniz en yeni iptal edilen satın alma işleminin, sıfır zamandan itibaren milisaniye cinsinden zamanı. Bu parametrenin değeri mevcut zamandan büyük olamaz ve sayfalandırma jetonu ayarlanmışsa yoksayılır. Varsayılan değer, geçerli saattir. Not: Bu filtre, yanıtta döndürülen gerçek geçersiz kılma zamanı değil, kaydın sistemlerimiz tarafından geçersiz kıldığı görülen zamana uygulanır.

type

integer

Yanıtta görmek istediğiniz iptal edilen satın alma işlemleri türü. Olası değerler: 0. Yanıtta yalnızca geçersiz kılınan uygulama içi ürün satın alma işlemleri döndürülür. Bu, varsayılan değerdir. 1. Hem geçersiz kılınan uygulama içi satın alma işlemleri hem de geçersiz kılınan abonelik satın alma işlemleri yanıtta döndürülür.

Not: İptal edilen abonelik satın alma işlemlerini almayı istemeden önce, yanıtta tek seferlik satın alma işlemlerini ve abonelikleri benzersiz şekilde tanımlayan orderId değerini kullanmaya başlamanız gerekir. Aksi takdirde, abonelik yenileme siparişleri aynı PurchaseToken'ı paylaştığı için 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 ödemelerin iptal edilen satın alma işlemlerini içerip içermeyeceği. Doğruysa iptal edilen ek 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 (yanlış) değerini alır.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

voidedpurchases.list API'si için 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)

Sayfalandırmayla ilgili genel bilgiler.

tokenPagination

object (TokenPagination)

Jeton sayfalandırması için sayfalandırma bilgileri.

voidedPurchases[]

object (VoidedPurchase)

Yetkilendirme kapsamları

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

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

PageSelection

voidedpurchases.list işleminin hangi ve kaç sonucu 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 dizin numarasını tanımlar. Bu seçenek yalnızca dizine eklenen sayfalama etkinse kullanılabilir.

token

string

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