Method: purchases.subscriptions.acknowledge

אישור רכישת מינוי.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
packageName

string

שם החבילה של האפליקציה שבה נרכש המנוי (לדוגמה, com.some.thing).
subscriptionId

string

הערה: החל מ-21 במאי 2025, לא נדרש subscriptionId, ולא מומלץ להשתמש בו למינוי עם חבילות. מזהה המינוי שנרכש (לדוגמה, monthly001).
token

string

האסימון שסופק למכשיר של המשתמש כשנרכש המינוי.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
שדות
developerPayload

string

מטען ייעודי (payload) לצירוף לרכישה.
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 יכולה להשתמש בו כדי לזהות פעילות לא סדירה. אל תשתמשו בשדה הזה כדי לאחסן פרטים אישיים מזהים (PII), כמו כתובות אימייל בטקסט גלוי. ניסיון לאחסן פרטים אישיים מזהים (PII) בשדה הזה יגרום לחסימת הרכישות. מומלץ להשתמש בהצפנה או בגיבוב חד-כיווני כדי ליצור מזהה מוסתר לשליחה אל Google Play.

המזהה הזה מוגבל ל-64 תווים.

אפשר להגדיר את השדה הזה רק לרכישות של חידוש מינוי. בקישור https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid מוסבר איך להגדיר את השדה הזה לרכישות שמתבצעות באמצעות תהליך החיוב הרגיל באפליקציה.
obfuscatedProfileId

string

אופציונלי. מחרוזת אופציונלית שעברה ערפול ומשויכת באופן ייחודי לפרופיל המשתמש של הרוכש באפליקציה.

אם מעבירים את הערך הזה, מערכת Google Play יכולה להשתמש בו כדי לזהות פעילות לא סדירה. אל תשתמשו בשדה הזה כדי לאחסן פרטים אישיים מזהים (PII), כמו כתובות אימייל בטקסט גלוי. ניסיון לאחסן פרטים אישיים מזהים (PII) בשדה הזה יגרום לחסימת הרכישות. מומלץ להשתמש בהצפנה או בגיבוב חד-כיווני כדי ליצור מזהה מוסתר לשליחה אל Google Play.

המזהה הזה מוגבל ל-64 תווים.

אפשר להגדיר את השדה הזה רק לרכישות של חידוש מינוי. במאמר https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid מוסבר איך להגדיר את השדה הזה לרכישות שמתבצעות באמצעות תהליך החיוב הרגיל על רכישות באפליקציות.