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

참고: 2025년 5월 21일부터 subscriptionId가 필수가 아니며 부가기능이 있는 정기 결제에는 권장되지 않습니다. 구매한 정기 결제 ID입니다 (예: '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를 참고하세요.