Method: externaltransactions.createexternaltransaction

새 외부 거래를 만듭니다.

HTTP 요청

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{parent=applications/*}/externalTransactions

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 이 외부 거래가 생성되는 상위 리소스입니다. 형식: applications/{packageName}

쿼리 매개변수

Parameters
externalTransactionId

string

필수 항목입니다. 외부 거래에 사용할 ID입니다. 앱의 기타 거래 전체에서 고유한 값이어야 합니다. 이 값은 1~63자(영문 기준)여야 하며, 유효한 문자는 /a-zA-Z0-9_-/입니다. 이 필드를 이메일과 같은 개인 식별 정보(PII)를 저장하는 데 사용하지 마세요. 이 필드에 PII를 저장하려고 하면 요청이 차단될 수 있습니다.

요청 본문

요청 본문에 ExternalTransaction의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 ExternalTransaction의 인스턴스가 포함됩니다.

샘플

다음은 샘플 요청입니다.

curl \   -X POST \   'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions?externalTransactionId=exampleExternalTransactionId' \   -H 'Accept: application/json' \   -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \   -H 'Content-Type: application/json' \   -d '{ \     "originalPreTaxAmount": { \       "currency": "USD", \       "priceMicros": "1000000" \     }, \     "originalTaxAmount": { \       "currency": "USD", \       "priceMicros": "100000" \     }, \     "transactionTime": "2023-05-05T12:00:00Z", \     "oneTimeTransaction": { \       "externalTransactionToken": "token-123" \     }, \     "userTaxAddress": { \       "regionCode": "US" \     } \   }'

다음은 샘플 응답입니다.

{   "createTime": "2023-04-20T14:23:18.121Z",   "currentPreTaxAmount": {     "currency": "USD",     "priceMicros": "12000000"   },   "currentTaxAmount": {     "currency": "USD",     "priceMicros": "1200000"   },   "externalTransactionId": "ext-trans-id-1234",   "oneTimeTransaction": {     "externalTransactionToken": "one-time-token-abc"   },   "originalPreTaxAmount": {     "currency": "USD",     "priceMicros": "15000000"   },   "originalTaxAmount": {     "currency": "USD",     "priceMicros": "1500000"   },   "packageName": "com.example.app",   "recurringTransaction": {     "externalSubscription": {       "subscriptionType": "RECURRING"     },     "externalTransactionToken": "recurring-token-xyz",     "initialExternalTransactionId": "ext-trans-id-5678",     "otherRecurringProduct": {}   },   "testPurchase": {},   "transactionProgramCode": 11,   "transactionState": "TRANSACTION_REPORTED",   "transactionTime": "2023-04-20T14:20:00.000Z",   "userTaxAddress": {     "regionCode": "US"   } }

승인 범위

다음 OAuth 범위가 필요합니다.

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