POST/v1/customers/google-play/link

Google Play 고객과 앱 계정 연결

검증한 Google Play 구매를 앱 계정에 연결합니다.

인증: Bearer필수 범위: customers:write

요청 본문

packageName필수

string

Purpl에 등록한 Android 패키지 이름입니다.

purchaseToken필수

string

Google Play에서 반환한 구매 토큰입니다.

productKind필수

subscription | one_time_product

Google Play 상품 종류입니다.

productIdentifier선택

string | null

일회성 구매 조회에 사용할 선택 상품 식별자입니다.

applicationAccountIdentifier필수

string

앱에서 사용하는 안정적인 계정 식별자입니다.

응답

200연결한 고객의 현재 권한입니다.

customerIdentifier필수

string | null · uuid

applicationIdentifier필수

string · uuid

entitlements필수

CustomerEntitlement[]

400요청 값이나 검증한 스토어 데이터가 올바르지 않습니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

401애플리케이션 API 자격 증명이 없거나 올바르지 않습니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

403애플리케이션 API 자격 증명에 필요한 범위가 없습니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

404앱, 스토어 구성, 고객 또는 페이월을 찾지 못했습니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

409고객 신원이 기존 검증 신원과 충돌합니다.

error필수

string

안정적인 기계 판독용 오류 코드입니다.

요청 예시

cURL

curl 'https://api.purpl.sh/v1/customers/google-play/link' \
  --header 'Authorization: Bearer <application-api-credential>' \
  --header 'Content-Type: application/json' \
  --data '{
    "packageName": "com.example.app",
    "purchaseToken": "<purchase-token>",
    "productKind": "subscription",
    "productIdentifier": "plus.monthly",
    "applicationAccountIdentifier": "user-123"
  }'