Method: purchases.subscriptionsv2.revoke

subscriptionsv2.یک خرید اشتراک را برای کاربر لغو کنید.

درخواست HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:revoke

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
packageName

string

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

token

string

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

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "revocationContext": {
    object (RevocationContext)
  }
}
فیلدها
revocationContext

object ( RevocationContext )

مورد نیاز. جزئیات بیشتر در مورد لغو اشتراک.

بدن پاسخگو

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

نمونه

نمونه درخواست زیر در زیر آمده است:

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptionsv2/tokens/sample_purchase_token:revoke' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "revocationContext": {
      "proratedRefund": {}
    }
  }'

محدوده مجوز

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

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

RevocationContext

زمینه لغو API buys.subscriptionsv2.revoke.

نمایندگی JSON 
{

  // Union field RefundType can be only one of the following:
  "fullRefund": {
    object (FullRefund)
  },
  "proratedRefund": {
    object (ProratedRefund)
  },
  "itemBasedRefund": {
    object (ItemBasedRefund)
  }
  // End of list of possible types for union field RefundType.
}
فیلدها
RefundType فیلد اتحادیه نوع بازپرداختی که باید اعطا شود را تعیین می کند. نوع بازپرداخت باید به عنوان بخشی از یک درخواست معتبر مشخص شود. RefundType تنها می تواند یکی از موارد زیر باشد:
fullRefund

object ( FullRefund )

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

proratedRefund

object ( ProratedRefund )

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

itemBasedRefund

object ( ItemBasedRefund )

اختیاری. زمانی استفاده می‌شود که یک مورد خاص باید در اشتراکی با موارد اضافی بازپرداخت شود.

بازپرداخت کامل

این نوع هیچ فیلدی ندارد.

برای تعیین اینکه نوع بازپرداخت در RevocationContext بازپرداخت کامل است یا خیر استفاده می شود.

بازپرداخت نسبتاً

این نوع هیچ فیلدی ندارد.

برای تعیین اینکه آیا نوع بازپرداخت در RevocationContext یک بازپرداخت نسبتاً است یا خیر استفاده می شود.

ItemBasedRefund

برای تعیین اینکه چه مورد خاصی را در اشتراکی با چندین مورد لغو کنیم استفاده می شود.

نمایندگی JSON 
{
  "productId": string
}
فیلدها
productId

string

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