Method: orders.reviewrefund

برای درخواست بازپرداخت وجه، اولویت بازپرداخت و نحوه‌ی استفاده از خرید را مشخص کنید

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
packageName

string

الزامی. نام بسته‌ی برنامه‌ای که این اشتراک یا آیتم درون‌برنامه‌ای برای آن خریداری شده است (برای مثال، 'com.some.thing').

orderId

string

الزامی. شناسه سفارش ارائه شده به کاربر هنگام خرید اشتراک یا سفارش درون‌برنامه‌ای.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
فیلدها
pendingRefundToken

string

الزامی. توکن بازپرداخت در حال انتظار که در اعلان بررسی بازپرداخت در حال انتظار درج شده است.

sampleContentProvided

boolean

الزامی. نشان می‌دهد که آیا قبل از خرید، نمونه رایگان، نسخه آزمایشی یا اطلاعاتی در مورد عملکرد ارائه داده‌اید یا خیر.

refundPreference

enum ( RefundPreference )

الزامی. بر اساس منطق عملیاتی شما، ترجیح شما را در مورد اینکه آیا فروشگاه Play باید بازپرداخت را اعطا کند یا خیر، نشان می‌دهد.

consumptionPercentageMilliunits

integer

اختیاری. درصد خرید درون‌برنامه‌ای که مشتری مصرف کرده است، به میلی‌لیتر. حداقل: ۰ حداکثر: ۱۰۰۰۰۰. برای برنامه‌های پولی، می‌توان این را حذف کرد. مثال: ۴۵۲۰۰ نشان‌دهنده ۴۵.۲٪ است.

consumptionUsageEvents[]

object ( ConsumptionUsageEvent )

اختیاری. فهرستی از رویدادها، که هر کدام نشان‌دهنده‌ی نمونه‌ای است که کاربر در آن کالا یا سرویس خریداری شده را مصرف یا استفاده کرده است. فهرست‌هایی با بیش از ۱۰۰۰ کالا رد خواهند شد.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ خالی است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

اولویت بازپرداخت

بر اساس منطق عملیاتی شما، ترجیح شما را در مورد اینکه آیا فروشگاه Play باید بازپرداخت را اعطا کند یا خیر، نشان می‌دهد.

انوم‌ها
REFUND_PREFERENCE_UNSPECIFIED ترجیح بازپرداخت سفارشات مشخص نشده است. این مقدار استفاده نمی‌شود.
DECLINE توسعه‌دهنده ترجیح می‌دهد که Play درخواست بازپرداخت را رد کند.
APPROVE توسعه‌دهنده ترجیح می‌دهد که Play کل مبلغ را بازپرداخت کند.
NEUTRAL توسعه‌دهنده هیچ ترجیحی در مورد تصمیم گوگل پلی برای بازپرداخت وجه ندارد

رویداد مصرف/استفاده

فهرستی از رویدادها، که هر کدام نشان‌دهنده‌ی نمونه‌ای است که کاربر در آن کالا یا سرویس خریداری شده را مصرف یا استفاده کرده است.

نمایش JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
فیلدها
obfuscatedAccountId

string

اختیاری. رشته مبهم‌سازی شده‌ای که به طور منحصر به فرد با حساب کاربری خریدار در برنامه مرتبط است. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String )

obfuscatedProfileId

string

اختیاری. رشته مبهم‌سازی شده‌ای که به طور منحصر به فرد با پروفایل کاربری خریدار در برنامه مرتبط است. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String )

consumptionTime

string ( Timestamp format)

اختیاری. زمانی که کاربر محتوا را مصرف، استفاده، دانلود، باز یا پخش کرده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

ipAddress

string

اختیاری. آدرس IP که از آن مصرف رخ داده است.

consumptionItemDescription

string

اختیاری. متن فرم رایگان که به توسعه‌دهندگان اجازه می‌دهد اطلاعات بیشتری در مورد کالای مصرفی ارائه دهند. حداکثر طول ۵۰۰۰ کاراکتر است.

location

object ( CoarseLocation )

اختیاری. موقعیت جغرافیایی که مصرف در آن رخ داده است.

موقعیت مکانی درشت

جزئیات دقیق موقعیت جغرافیایی محل وقوع مصرف.

نمایش JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
فیلدها
regionCode

string

الزامی. کد منطقه CLDR کشور/منطقه آدرس. این مقدار هرگز استنباط نمی‌شود و شما باید مطمئن شوید که مقدار صحیح است. مثال: "CH" برای سوئیس.

administrativeArea

string

اختیاری. بالاترین تقسیم‌بندی اداری که برای آدرس‌های پستی یک کشور یا منطقه استفاده می‌شود. برای مثال، این می‌تواند یک ایالت، یک استان، یک اوبلاست یا یک بخشدار باشد. برای اسپانیا، این استان است و نه یک جامعه خودمختار (برای مثال، "بارسلونا" و نه "کاتالونیا"). بسیاری از کشورها از یک منطقه اداری در آدرس‌های پستی استفاده نمی‌کنند. برای مثال، در سوئیس، این باید بدون جمعیت باقی بماند.

locality

string

اختیاری. عموماً به بخش شهر یا شهرستان آدرس اشاره دارد. مثال‌ها: شهر ایالات متحده، شهر فناوری اطلاعات، شهر پستی بریتانیا. در مناطقی از جهان که محل‌ها به خوبی تعریف نشده‌اند یا به خوبی در این ساختار جای نمی‌گیرند، locality خالی بگذارید.

sublocality

string

اختیاری. محل قرارگیری آدرس. برای مثال، می‌تواند یک محله، بخش یا ناحیه باشد. برای اکثر آدرس‌ها، می‌توانید این مورد را حذف کنید.