Method: orders.reviewrefund

Memberikan preferensi pengembalian dana dan penggunaan pembelian untuk permintaan chargeback

Permintaan HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
packageName

string

Wajib. Nama paket aplikasi tempat langganan atau item dalam aplikasi ini dibeli (misalnya, 'com.some.thing').
orderId

string

Wajib. ID pesanan yang diberikan kepada pengguna saat langganan atau pesanan dalam aplikasi dibeli.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
Kolom
pendingRefundToken

string

Wajib. Token pengembalian dana tertunda yang disertakan dalam notifikasi peninjauan pengembalian dana tertunda.
sampleContentProvided

boolean

Wajib. Menunjukkan apakah Anda memberikan sampel gratis, uji coba, atau informasi tentang fungsi sebelum pembelian.
refundPreference

enum (RefundPreference)

Wajib. Menunjukkan preferensi Anda, berdasarkan logika operasional Anda, apakah Play Store harus memberikan pengembalian dana.
consumptionPercentageMilliunits

integer

Opsional. Persentase pembelian Dalam Aplikasi yang digunakan pelanggan, dalam miliunit. Minimum: 0 Maksimum: 100.000. Untuk aplikasi berbayar, kolom ini dapat dihilangkan. Contoh : 45200 mewakili 45,2%.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

Opsional. Daftar peristiwa, yang masing-masing mewakili instance saat pengguna menggunakan atau menggunakan item atau layanan yang dibeli. Daftar dengan lebih dari 1.000 item akan ditolak.

Isi respons

Jika berhasil, isi respons akan kosong.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

RefundPreference

Menunjukkan preferensi Anda, berdasarkan logika operasional Anda, apakah Play Store harus memberikan pengembalian dana.

Enum
REFUND_PREFERENCE_UNSPECIFIED orders.refund preference tidak ditentukan. Nilai ini tidak digunakan.
DECLINE Developer lebih memilih Play menolak pengembalian dana.
APPROVE Developer lebih memilih Play memberikan pengembalian dana penuh.
NEUTRAL Developer tidak memiliki preferensi tentang keputusan Google Play untuk memberikan pengembalian dana

ConsumptionUsageEvent

Daftar peristiwa, yang masing-masing mewakili instance saat pengguna menggunakan atau menggunakan item atau layanan yang dibeli.

Representasi JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
Kolom
obfuscatedAccountId

string

Opsional. String yang diacak yang secara unik dikaitkan dengan akun pengguna pembeli di aplikasi. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

Opsional. String yang diacak yang secara unik dikaitkan dengan profil pengguna pembeli di aplikasi. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

Opsional. Waktu saat pengguna menggunakan, menggunakan, mendownload, membuka, atau melakukan streaming konten.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
ipAddress

string

Opsional. Alamat IP tempat penggunaan terjadi.
consumptionItemDescription

string

Opsional. Teks bentuk bebas yang memungkinkan developer memberikan info selengkapnya tentang item yang digunakan. Panjang maksimum adalah 5.000 karakter.
location

object (CoarseLocation)

Opsional. Lokasi geografis tempat penggunaan terjadi.

CoarseLocation

Detail lokasi Geografis kasar untuk tempat penggunaan terjadi.

Representasi JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
Kolom
regionCode

string

Wajib. Kode wilayah CLDR negara/wilayah alamat. Nilai ini tidak pernah disimpulkan dan Anda harus memastikan nilainya benar. Contoh: "CH" untuk Swiss.
administrativeArea

string

Opsional. Subdivisi administratif tertinggi yang digunakan untuk alamat pos negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Untuk Spanyol, ini adalah provinsi dan bukan komunitas otonom (misalnya, "Barcelona" dan bukan "Catalonia"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan kosong.
locality

string

Opsional. Secara umum merujuk pada bagian kota dari alamat tersebut. Contoh: US city, IT comune, UK post town. Di wilayah dunia yang lokalitasnya tidak ditentukan dengan baik atau tidak sesuai dengan struktur ini, biarkan locality kosong.
sublocality

string

Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa lingkungan, borough, atau distrik. Untuk sebagian besar alamat, Anda dapat menghilangkannya.