Method: purchases.subscriptionsv2.revoke

‫subscriptionsv2.revoke a subscription purchase for the user

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
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

سياق الإبطال لواجهة برمجة التطبيقات purchases.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)

اختياريّ. تُستخدَم هذه السمة عندما يجب ردّ الأموال المدفوعة مقابل سلعة معيّنة في اشتراك يتضمّن سلعًا إضافية.

FullRefund

لا يحتوي هذا النوع على أي حقول.

تُستخدَم لتحديد ما إذا كان نوع ردّ الأموال في RevocationContext هو ردّ الأموال بالكامل.

ProratedRefund

لا يحتوي هذا النوع على أي حقول.

يُستخدَم لتحديد ما إذا كان نوع ردّ الأموال في RevocationContext هو ردّ أموال مُقسَّم على أساس تناسبي.

ItemBasedRefund

تُستخدَم لتحديد العنصر المحدّد الذي يجب إبطاله في اشتراك يتضمّن عناصر متعددة.

تمثيل JSON 
{
  "productId": string
}
الحقول
productId

string

مطلوب. إذا كان الاشتراك يتضمّن إضافات، يجب إدخال معرّف المنتج الخاص بعنصر الاشتراك المطلوب إبطاله.