Method: purchases.subscriptions.acknowledge

الإقرار بعملية شراء اشتراك

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge

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

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

المعلمات
packageName

string

اسم حزمة التطبيق الذي تم شراء هذا الاشتراك له (على سبيل المثال، ‎com.some.thing).

subscriptionId

string

ملاحظة: اعتبارًا من 21 أيار (مايو) 2025، لم يعُد subscriptionId مطلوبًا، ولا يُنصح باستخدامه للاشتراك مع الإضافات. معرّف الاشتراك الذي تم شراؤه (على سبيل المثال، "monthly001").

token

string

الرمز المميّز الذي تم تقديمه لجهاز المستخدم عند شراء الاشتراك

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

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

string

الحمولة التي سيتم إرفاقها بعملية الشراء

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.

عيّنة

في ما يلي مثال على طلب:

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly_premium_001/tokens/abcDEF123ghiJKL456mnoPQR789:acknowledge' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "developerPayload": "AppSpecificInfo-UserID-12345"
  }'

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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