Method: purchases.subscriptions.acknowledge

Mengonfirmasi pembelian langganan.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
packageName

string

Nama paket aplikasi yang langganannya ini dibeli (misalnya, 'com.some.thing').
subscriptionId

string

Catatan: Mulai 21 Mei 2025, subscriptionId tidak diperlukan, dan tidak direkomendasikan untuk langganan dengan add-on. ID langganan yang dibeli (misalnya, 'monthly001').
token

string

Token yang diberikan ke perangkat pengguna saat langganan dibeli.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
Kolom
developerPayload

string

Payload untuk dilampirkan pada pembelian.
externalAccountIds

object (ExternalAccountIds)

Opsional. ID akun pengguna di aplikasi Anda.

Isi respons

Jika berhasil, isi respons akan kosong.

Contoh

Berikut adalah contoh permintaan:

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

ExternalAccountIds

ID akun pengguna di aplikasi Anda.

Representasi JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Kolom
obfuscatedAccountId

string

Opsional. Menentukan string obfuscation opsional yang secara unik terkait dengan akun pengguna pembeli di aplikasi Anda.

Jika Anda meneruskan nilai ini, Google Play dapat menggunakannya untuk mendeteksi aktivitas yang tidak wajar. Jangan gunakan kolom ini untuk menyimpan Informasi Identitas Pribadi (PII) seperti email dalam teks biasa. Mencoba menyimpan PII di kolom ini akan mengakibatkan pembelian diblokir. Google Play merekomendasikan agar Anda menggunakan enkripsi atau hash satu arah untuk membuat ID yang di-obfuscate untuk dikirim ke Google Play.

ID ini dibatasi hingga 64 karakter.

Kolom ini hanya dapat disetel untuk pembelian langganan ulang. Lihat https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid untuk menyetel kolom ini bagi pembelian yang dilakukan menggunakan alur penagihan dalam aplikasi standar.
obfuscatedProfileId

string

Opsional. Menentukan string obfuscation opsional yang secara unik terkait dengan profil pengguna pembeli di aplikasi Anda.

Jika Anda meneruskan nilai ini, Google Play dapat menggunakannya untuk mendeteksi aktivitas yang tidak wajar. Jangan gunakan kolom ini untuk menyimpan Informasi Identitas Pribadi (PII) seperti email dalam teks biasa. Mencoba menyimpan PII di kolom ini akan mengakibatkan pembelian diblokir. Google Play merekomendasikan agar Anda menggunakan enkripsi atau hash satu arah untuk membuat ID yang di-obfuscate untuk dikirim ke Google Play.

ID ini dibatasi hingga 64 karakter.

Kolom ini hanya dapat disetel untuk pembelian langganan ulang. Lihat https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid untuk menyetel kolom ini untuk pembelian yang dilakukan menggunakan alur penagihan dalam aplikasi standar.