Method: purchases.subscriptions.acknowledge

Abonelik satın alma işlemini onaylar.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
packageName

string

Bu aboneliğin satın alındığı uygulamanın paket adı (örneğin, "com.some.thing").
subscriptionId

string

Not: 21 Mayıs 2025'ten itibaren subscriptionId gerekli değildir ve eklentili abonelikler için önerilmez. Satın alınan abonelik kimliği (örneğin, "monthly001").
token

string

Abonelik satın alındığında kullanıcının cihazına sağlanan jeton.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
Alanlar
developerPayload

string

Satın alma işlemine eklenecek yük.
externalAccountIds

object (ExternalAccountIds)

İsteğe bağlıdır. Uygulamanızdaki kullanıcı hesabı tanımlayıcısı.

Yanıt metni

Başarılı olursa yanıt gövdesi boş olur.

Örnek

Aşağıda örnek bir istek verilmiştir:

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

ExternalAccountIds

Uygulamanızdaki kullanıcı hesabı tanımlayıcısı.

JSON gösterimi 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Alanlar
obfuscatedAccountId

string

İsteğe bağlıdır. Satın alan kullanıcının uygulamanızdaki kullanıcı hesabıyla benzersiz şekilde ilişkilendirilmiş isteğe bağlı bir karartılmış dizeyi belirtir.

Bu değeri iletirseniz Google Play, düzensiz etkinliği tespit etmek için bu değeri kullanabilir. Bu alanı, e-posta adresleri gibi kimliği tanımlayabilecek bilgileri (PII) düz metin olarak depolamak için kullanmayın. Bu alanda kimliği tanımlayabilecek bilgiler (PII) depolamaya çalışmak, satın alma işlemlerinin engellenmesine neden olur. Google Play, Google Play'e gönderilecek karartılmış bir tanımlayıcı oluşturmak için şifreleme veya tek yönlü karma kullanmanızı önerir.

Bu tanımlayıcı 64 karakterle sınırlıdır.

Bu alan yalnızca yeniden abonelik satın alma işlemleri için ayarlanabilir. Standart uygulama içi faturalandırma akışı kullanılarak yapılan satın alma işlemlerinde bu alanı ayarlamak için https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid adresini ziyaret edin.
obfuscatedProfileId

string

İsteğe bağlıdır. Satın alan kullanıcının uygulamanızdaki kullanıcı profiliyle benzersiz şekilde ilişkilendirilmiş isteğe bağlı bir karartılmış dizeyi belirtir.

Bu değeri iletirseniz Google Play, düzensiz etkinliği tespit etmek için bu değeri kullanabilir. Bu alanı, e-posta adresleri gibi kimliği tanımlayabilecek bilgileri (PII) düz metin olarak depolamak için kullanmayın. Bu alanda kimliği tanımlayabilecek bilgiler (PII) depolamaya çalışmak, satın alma işlemlerinin engellenmesine neden olur. Google Play, Google Play'e gönderilecek karartılmış bir tanımlayıcı oluşturmak için şifreleme veya tek yönlü karma kullanmanızı önerir.

Bu tanımlayıcı 64 karakterle sınırlıdır.

Bu alan yalnızca yeniden abonelik satın alma işlemleri için ayarlanabilir. Standart uygulama içi faturalandırma akışı kullanılarak yapılan satın alma işlemlerinde bu alanı ayarlamak için https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid adresini ziyaret edin.