Method: purchases.subscriptions.acknowledge

Xác nhận giao dịch mua gói thuê bao.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
packageName

string

Tên gói của ứng dụng mà người dùng đã mua gói thuê bao này (ví dụ: "com.some.thing").
subscriptionId

string

Lưu ý: Kể từ ngày 21 tháng 5 năm 2025, bạn không bắt buộc phải dùng subscriptionId và không nên dùng cho gói thuê bao có tiện ích bổ sung. Mã nhận dạng gói thuê bao được mua (ví dụ: "monthly001").
token

string

Mã thông báo được cung cấp cho thiết bị của người dùng khi người dùng mua gói thuê bao.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
Trường
developerPayload

string

Tải trọng cần đính kèm vào giao dịch mua.
externalAccountIds

object (ExternalAccountIds)

Không bắt buộc. Giá trị nhận dạng tài khoản người dùng trong ứng dụng của bạn.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ trống.

Mẫu

Sau đây là một yêu cầu mẫu:

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"
  }'

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

ExternalAccountIds

Giá trị nhận dạng tài khoản người dùng trong ứng dụng của bạn.

Biểu diễn dưới dạng JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Trường
obfuscatedAccountId

string

Không bắt buộc. Chỉ định một chuỗi bị làm rối (không bắt buộc) được liên kết với một tài khoản người dùng duy nhất của người mua trong ứng dụng của bạn.

Nếu bạn truyền giá trị này, Google Play có thể sử dụng giá trị này để phát hiện hoạt động bất thường. Đừng dùng trường này để lưu trữ bất kỳ Thông tin nhận dạng cá nhân (PII) nào, chẳng hạn như email ở dạng văn bản thô. Nếu cố gắng lưu trữ thông tin nhận dạng cá nhân (PII) trong trường này, bạn sẽ không mua được hàng. Google Play khuyến nghị bạn sử dụng phương thức mã hoá hoặc hàm băm một chiều để tạo một giá trị nhận dạng bị làm rối mã nguồn nhằm gửi đến Google Play.

Giá trị nhận dạng này chỉ được dài tối đa 64 ký tự.

Bạn chỉ có thể đặt trường này cho giao dịch mua lại gói thuê bao. Hãy xem https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid để đặt trường này cho các giao dịch mua được thực hiện bằng quy trình thanh toán tiêu chuẩn trong ứng dụng.
obfuscatedProfileId

string

Không bắt buộc. Chỉ định một chuỗi bị làm rối (không bắt buộc) được liên kết với một hồ sơ người dùng duy nhất của người mua trong ứng dụng của bạn.

Nếu bạn truyền giá trị này, Google Play có thể sử dụng giá trị này để phát hiện hoạt động bất thường. Đừng dùng trường này để lưu trữ bất kỳ Thông tin nhận dạng cá nhân (PII) nào, chẳng hạn như email ở dạng văn bản thô. Nếu cố gắng lưu trữ thông tin nhận dạng cá nhân (PII) trong trường này, bạn sẽ không mua được hàng. Google Play khuyến nghị bạn sử dụng phương thức mã hoá hoặc hàm băm một chiều để tạo một giá trị nhận dạng bị làm rối mã nguồn nhằm gửi đến Google Play.

Giá trị nhận dạng này chỉ được dài tối đa 64 ký tự.

Bạn chỉ có thể đặt trường này cho giao dịch mua lại gói thuê bao. Hãy xem https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid để đặt trường này cho các giao dịch mua được thực hiện bằng quy trình thanh toán tiêu chuẩn trong ứng dụng.