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,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
الحقول
developerPayload

string

الحِزمة المراد إرفاقها بعملية الشراء
externalAccountIds

object (ExternalAccountIds)

اختيارية: معرّف حساب المستخدم في تطبيقك

نص الاستجابة

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

عيّنة

في ما يلي نموذج طلب:

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

ExternalAccountIds

معرّف حساب المستخدم في تطبيقك

تمثيل JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
الحقول
obfuscatedAccountId

string

اختيارية: تحدّد هذه السمة سلسلة اختيارية مبهمة مرتبطة بشكل فريد بحساب المستخدم الخاص بالمشتري في تطبيقك.

في حال إدخال هذه القيمة، يمكن أن يستخدمها Google Play لرصد الأنشطة غير المنتظمة. لا تستخدِم هذا الحقل لتخزين أي معلومات تكشف الهوية الشخصية، مثل عناوين البريد الإلكتروني بنص عادي. وستؤدي محاولة تخزين معلومات تحديد الهوية الشخصية في هذا الحقل إلى حظر عمليات الشراء. ينصح Google Play باستخدام التشفير أو التجزئة أحادية الاتجاه لإنشاء معرّف مشوّش لإرساله إلى Google Play.

يقتصر هذا المعرّف على 64 حرفًا.

لا يمكن ضبط هذا الحقل إلا لعمليات شراء إعادة الاشتراك. راجِع https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid لضبط هذا الحقل لعمليات الشراء التي تتم باستخدام مسار الفوترة العادي داخل التطبيق.
obfuscatedProfileId

string

اختيارية: تحدّد هذه السمة سلسلة اختيارية مشوّشة مرتبطة بشكلٍ فريد بملف المستخدم الخاص بالمشتري في تطبيقك.

في حال إدخال هذه القيمة، يمكن أن يستخدمها Google Play لرصد الأنشطة غير المنتظمة. لا تستخدِم هذا الحقل لتخزين أي معلومات تكشف الهوية الشخصية، مثل عناوين البريد الإلكتروني بنص عادي. وستؤدي محاولة تخزين معلومات تحديد الهوية الشخصية في هذا الحقل إلى حظر عمليات الشراء. ينصح Google Play باستخدام التشفير أو التجزئة أحادية الاتجاه لإنشاء معرّف مشوّش لإرساله إلى Google Play.

يقتصر هذا المعرّف على 64 حرفًا.

لا يمكن ضبط هذا الحقل إلا لعمليات شراء إعادة الاشتراك. راجِع https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid لضبط هذا الحقل لعمليات الشراء التي تتم باستخدام مسار الفوترة العادي داخل التطبيق.