Method: purchases.subscriptions.acknowledge

Potwierdza zakup subskrypcji.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Nazwa pakietu aplikacji, w której zakupiono ten abonament (np. „com.some.thing”).
subscriptionId

string

Uwaga: od 21 maja 2025 r. identyfikator subskrypcji nie jest wymagany i nie jest zalecany w przypadku subskrypcji z dodatkami. Identyfikator kupionej subskrypcji (np. „monthly001”).
token

string

Token przekazany na urządzenie użytkownika w momencie zakupu subskrypcji.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "developerPayload": string,
  "externalAccountIds": {
    object (ExternalAccountIds)
  }
}
Pola
developerPayload

string

Ładunek dołączany do zakupu.
externalAccountIds

object (ExternalAccountIds)

Opcjonalnie: Identyfikator konta użytkownika w aplikacji.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pusta.

Przykład

Oto przykładowe żądanie:

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

ExternalAccountIds

Identyfikator konta użytkownika w aplikacji.

Zapis JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
Pola
obfuscatedAccountId

string

Opcjonalnie: Określa opcjonalny zaciemniony ciąg znaków, który jest unikalnie powiązany z kontem użytkownika kupującego w Twojej aplikacji.

Jeśli przekażesz tę wartość, Google Play może jej użyć do wykrywania nietypowej aktywności. Nie używaj tego pola do przechowywania żadnych informacji umożliwiających identyfikację, takich jak adresy e-mail w formie zwykłego tekstu. Próba zapisania w tym polu informacji umożliwiających identyfikację konkretnej osoby spowoduje zablokowanie zakupu. Google Play zaleca używanie szyfrowania lub funkcji skrótu jednokierunkowego do generowania zaciemnionego identyfikatora, który ma być wysyłany do Google Play.

Ten identyfikator może mieć maksymalnie 64 znaki.

To pole można ustawić tylko w przypadku ponownej subskrypcji. Informacje o ustawianiu tego pola w przypadku zakupów dokonywanych przy użyciu standardowego procesu rozliczeń w aplikacji znajdziesz na stronie https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid.
obfuscatedProfileId

string

Opcjonalnie: Określa opcjonalny zaciemniony ciąg znaków, który jest jednoznacznie powiązany z profilem użytkownika kupującego w Twojej aplikacji.

Jeśli przekażesz tę wartość, Google Play może jej użyć do wykrywania nietypowej aktywności. Nie używaj tego pola do przechowywania żadnych informacji umożliwiających identyfikację, takich jak adresy e-mail w formie zwykłego tekstu. Próba zapisania w tym polu informacji umożliwiających identyfikację konkretnej osoby spowoduje zablokowanie zakupu. Google Play zaleca używanie szyfrowania lub funkcji skrótu jednokierunkowego do generowania zaciemnionego identyfikatora, który ma być wysyłany do Google Play.

Ten identyfikator może mieć maksymalnie 64 znaki.

To pole można ustawić tylko w przypadku ponownej subskrypcji. Aby ustawić to pole w przypadku zakupów dokonywanych przy użyciu standardowego procesu rozliczeń w aplikacji, zapoznaj się z artykułem https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid.