Method: purchases.subscriptions.acknowledge

خرید اشتراک را تأیید می‌کند.

درخواست HTTP

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

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

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

پارامترها
packageName

string

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

subscriptionId

string

توجه: از ۲۱ مه ۲۰۲۵، شناسه اشتراک الزامی نیست و برای اشتراک با افزونه‌ها توصیه نمی‌شود. شناسه اشتراک خریداری شده (برای مثال، '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

شناسه‌های حساب خارجی

شناسه حساب کاربری در برنامه شما.

نمایش JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
فیلدها
obfuscatedAccountId

string

اختیاری. یک رشته مبهم اختیاری را مشخص می‌کند که به طور منحصر به فرد با حساب کاربری خریدار در برنامه شما مرتبط است.

اگر این مقدار را وارد کنید، گوگل پلی می‌تواند از آن برای تشخیص فعالیت‌های غیرعادی استفاده کند. از این فیلد برای ذخیره هرگونه اطلاعات شخصی قابل شناسایی (PII) مانند ایمیل‌ها به صورت متن ساده استفاده نکنید. تلاش برای ذخیره PII در این فیلد منجر به مسدود شدن خریدها خواهد شد. گوگل پلی توصیه می‌کند که از رمزگذاری یا هش یک طرفه برای ایجاد یک شناسه مبهم برای ارسال به گوگل پلی استفاده کنید.

این شناسه به ۶۴ کاراکتر محدود شده است.

این فیلد فقط برای خریدهای اشتراک مجدد قابل تنظیم است. برای تنظیم این فیلد برای خریدهای انجام شده با استفاده از جریان صورتحساب استاندارد درون برنامه‌ای، به https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid مراجعه کنید.

obfuscatedProfileId

string

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

اگر این مقدار را وارد کنید، گوگل پلی می‌تواند از آن برای تشخیص فعالیت‌های غیرعادی استفاده کند. از این فیلد برای ذخیره هرگونه اطلاعات شخصی قابل شناسایی (PII) مانند ایمیل‌ها به صورت متن ساده استفاده نکنید. تلاش برای ذخیره PII در این فیلد منجر به مسدود شدن خریدها خواهد شد. گوگل پلی توصیه می‌کند که از رمزگذاری یا هش یک طرفه برای ایجاد یک شناسه مبهم برای ارسال به گوگل پلی استفاده کنید.

این شناسه به ۶۴ کاراکتر محدود شده است.

این فیلد فقط برای خریدهای اشتراک مجدد قابل تنظیم است. برای تنظیم این فیلد برای خریدهای انجام شده با استفاده از جریان صورتحساب استاندارد درون برنامه‌ای، به https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid مراجعه کنید.