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 จะใช้ค่าดังกล่าวเพื่อตรวจหากิจกรรมที่ผิดปกติได้ อย่าใช้ช่องนี้เพื่อจัดเก็บข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) เช่น อีเมลในข้อความธรรมดา การพยายามจัดเก็บ PII ในช่องนี้จะทำให้ระบบบล็อกการซื้อ Google Play ขอแนะนำให้คุณใช้การเข้ารหัสหรือแฮชแบบทางเดียวเพื่อสร้างตัวระบุที่ผ่านการปกปิดเพื่อส่งไปยัง Google Play

ตัวระบุนี้จำกัดไว้ที่ 64 อักขระ

ตั้งค่าฟิลด์นี้ได้เฉพาะสำหรับการซื้อการสมัครใช้บริการซ้ำ ดู https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid เพื่อตั้งค่าฟิลด์นี้สำหรับการซื้อที่ทำโดยใช้ขั้นตอนการเรียกเก็บเงินมาตรฐานในแอป
obfuscatedProfileId

string

ไม่บังคับ ระบุสตริงที่ซับซ้อนที่ไม่บังคับซึ่งเชื่อมโยงกับโปรไฟล์ผู้ใช้ของผู้ซื้อในแอปของคุณโดยเฉพาะ

หากส่งค่านี้ Google Play จะใช้ค่าดังกล่าวเพื่อตรวจหากิจกรรมที่ผิดปกติได้ อย่าใช้ช่องนี้เพื่อจัดเก็บข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) เช่น อีเมลในข้อความธรรมดา การพยายามจัดเก็บ PII ในช่องนี้จะทำให้ระบบบล็อกการซื้อ Google Play ขอแนะนำให้คุณใช้การเข้ารหัสหรือแฮชแบบทางเดียวเพื่อสร้างตัวระบุที่ผ่านการปกปิดเพื่อส่งไปยัง Google Play

ตัวระบุนี้จำกัดไว้ที่ 64 อักขระ

ตั้งค่าฟิลด์นี้ได้เฉพาะสำหรับการซื้อการสมัครใช้บริการซ้ำ ดู https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid เพื่อตั้งค่าฟิลด์นี้สำหรับการซื้อที่ทำโดยใช้ขั้นตอนการเรียกเก็บเงินในแอปมาตรฐาน