Method: orders.reviewrefund

Ters ibraz isteği için geri ödeme tercihi ve satın alma işlemi kullanımı sağlama

HTTP isteği

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

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

Yol parametreleri

Parametreler
packageName

string

Zorunlu. Bu aboneliğin veya uygulama içi öğenin satın alındığı uygulamanın paket adı (örneğin, "com.some.thing").
orderId

string

Zorunlu. Abonelik veya uygulama içi sipariş satın alındığında kullanıcıya sağlanan sipariş kimliği.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
Alanlar
pendingRefundToken

string

Zorunlu. Beklemedeki geri ödeme inceleme bildirimine dahil edilen beklemedeki geri ödeme jetonu.
sampleContentProvided

boolean

Zorunlu. Satın alma işleminden önce ücretsiz örnek, deneme veya işlevsellik hakkında bilgi sağlayıp sağlamadığınızı gösterir.
refundPreference

enum (RefundPreference)

Zorunlu. Play Store'un geri ödeme yapıp yapmaması gerektiğiyle ilgili, operasyonel mantığınıza dayalı tercihinizi gösterir.
consumptionPercentageMilliunits

integer

İsteğe bağlı. Müşterinin kullandığı uygulama içi satın alma yüzdesi (mili birim cinsinden). Minimum: 0 Maksimum: 100.000. Ücretli uygulamalarda bu bilgi atlanabilir. Örnek : 45200, %45,2'yi temsil eder.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

İsteğe bağlı. Kullanıcının satın alınan öğeyi veya hizmeti kullandığı ya da tükettiği her durumu temsil eden etkinliklerin listesi. 1.000'den fazla öğe içeren listeler reddedilir.

Yanıt metni

Başarılı olursa yanıt gövdesi boş olur.

Yetkilendirme kapsamları

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

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

RefundPreference

Play Store'un geri ödeme yapıp yapmaması gerektiğiyle ilgili, operasyonel mantığınıza dayalı tercihinizi gösterir.

Sıralamalar
REFUND_PREFERENCE_UNSPECIFIED orders.refund tercihi belirtilmemiş. Bu değer kullanılmaz.
DECLINE Geliştirici, Play'in geri ödemeyi reddetmesini tercih ediyorsa.
APPROVE Geliştirici, Play'in geri ödemeyi tam olarak yapmasını tercih ediyor.
NEUTRAL Geliştirici, Google Play'in geri ödeme yapma kararıyla ilgili bir tercihte bulunmuyor.

ConsumptionUsageEvent

Kullanıcının satın alınan öğeyi veya hizmeti kullandığı ya da tükettiği her durumu temsil eden etkinliklerin listesi.

JSON gösterimi 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
Alanlar
obfuscatedAccountId

string

İsteğe bağlı. Uygulamadaki alıcının kullanıcı hesabıyla benzersiz şekilde ilişkilendirilmiş karartılmış dize. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

İsteğe bağlı. Satın alan kullanıcının uygulamadaki kullanıcı profiliyle benzersiz şekilde ilişkilendirilmiş karartılmış dize. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

İsteğe bağlı. Kullanıcının içeriği kullandığı, indirdiği, açtığı veya içeriğin akışını gerçekleştirdiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
ipAddress

string

İsteğe bağlı. Tüketimin gerçekleştiği IP adresi.
consumptionItemDescription

string

İsteğe bağlı. Geliştiricilerin tüketilen öğe hakkında daha fazla bilgi vermesine olanak tanıyan serbest biçimli metin. Maksimum uzunluk 5.000 karakterdir.
location

object (CoarseLocation)

İsteğe bağlı. Tüketimin gerçekleştiği coğrafi konum.

CoarseLocation

Tüketimin gerçekleştiği yerle ilgili yaklaşık coğrafi konum ayrıntıları.

JSON gösterimi 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
Alanlar
regionCode

string

Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu değer hiçbir zaman çıkarılmaz ve değerin doğru olduğundan emin olmanız gerekir. Örnek: İsviçre için "CH".
administrativeArea

string

İsteğe bağlı. Bir ülkenin veya bölgenin posta adresleri için kullanılan en yüksek idari alt birim. Örneğin, bu bir eyalet, il, oblast veya idari bölge olabilir. İspanya için bu, özerk topluluk değil, eyalettir (örneğin, "Katalonya" değil, "Barselona"). Birçok ülkede posta adreslerinde idari bölge kullanılmaz. Örneğin İsviçre'de bu alan doldurulmamalıdır.
locality

string

İsteğe bağlı. Genellikle adresin şehir veya kasaba kısmını ifade eder. Örnekler: ABD şehri, İtalya komünü, Birleşik Krallık posta bölgesi. Dünyanın, yerleşim yerlerinin iyi tanımlanmadığı veya bu yapıya iyi uymadığı bölgelerinde locality alanını boş bırakın.
sublocality

string

İsteğe bağlı. Adresin bulunduğu alt yerleşim birimi. Örneğin, bu bir mahalle, ilçe veya bölge olabilir. Çoğu adres için bunu atlayabilirsiniz.