REST Resource: externaltransactions

리소스: ExternalTransaction

외부 거래의 세부정보입니다.

JSON 표현 
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },
  "transactionProgramCode": integer,

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.

  // Union field program_details can be only one of the following:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  }
  // End of list of possible types for union field program_details.
}
필드
packageName

string

출력 전용입니다. 외부 거래의 리소스 이름입니다. 인앱 상품이 판매된 애플리케이션의 패키지 이름입니다 (예: 'com.some.app').
externalTransactionId

string

출력 전용입니다. 이 거래의 ID입니다. 동일한 패키지의 모든 거래 ID는 고유해야 합니다. 외부 거래 생성 시 설정됩니다.
originalPreTaxAmount

object (Price)

필수 항목입니다. 세금이 부과되기 전 원래 거래 금액입니다. 환불이 적용되기 전에 Google에 원래 고지된 세전 금액을 나타냅니다.
originalTaxAmount

object (Price)

필수 항목입니다. 원래 세금 금액입니다. 환불이 적용되기 전에 Google에 원래 고지된 세금 금액을 나타냅니다.
currentPreTaxAmount

object (Price)

출력 전용입니다. 세금이 부과되기 전 현재 거래 금액입니다. 이 거래에 적용되었을 수 있는 환불을 포함해 최근 세전 금액을 나타냅니다.
currentTaxAmount

object (Price)

출력 전용입니다. 현재 세금 금액입니다. 이 거래에 적용되었을 수 있는 환불을 포함해 최근 세금 금액을 나타냅니다.
testPurchase

object (ExternalTransactionTestPurchase)

출력 전용입니다. 설정된 경우 이 거래는 테스트 구매였습니다. Google에서는 테스트 거래에 비용을 청구하지 않습니다.
transactionTime

string (Timestamp format)

필수 항목입니다. 거래가 완료된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
createTime

string (Timestamp format)

출력 전용입니다. 거래가 생성된 시간입니다. Google에 거래가 통지된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
transactionState

enum (TransactionState)

출력 전용입니다. 거래의 현재 상태입니다.
userTaxAddress

object (ExternalTransactionAddress)

필수 항목입니다. 세금 계산을 위한 사용자 주소입니다.
transactionProgramCode

integer

선택사항입니다. 파트너 프로그램에 참여하는 적격 앱의 서비스 수수료를 결정하는 데 사용되는 거래 프로그램 코드입니다. Play 미디어 경험 프로그램 (https://play.google.com/console/about/programs/mediaprogram/)에 참여하는 개발자는 개발자 제공 결제 거래를 보고할 때 프로그램 코드를 제공해야 합니다. 자격 요건을 충족하는 개발자는 BDM에게 문의하여 이 필드를 설정하는 방법을 자세히 알아보세요. 참고: 이 필드는 외부 제안 거래에 사용할 수 없습니다.
통합 필드 transaction_type. 수행된 거래의 유형입니다. transaction_type은 다음 중 하나여야 합니다.
oneTimeTransaction

object (OneTimeExternalTransaction)

일회성 거래이며 정기 결제에 포함되지 않습니다.
recurringTransaction

object (RecurringExternalTransaction)

이 거래는 반복되는 일련의 거래에 포함됩니다.
통합 필드 program_details. 거래 보고에 필요한 프로그램별 세부정보입니다. 세부정보는 거래와 연결된 프로그램에 대해서만 설정해야 합니다. program_details은 다음 중 하나여야 합니다.
externalOfferDetails

object (ExternalOfferDetails)

선택사항입니다. 외부 혜택 거래를 정확하게 보고하는 데 필요한 세부정보입니다.

ExternalTransactionTestPurchase

이 유형에는 필드가 없습니다.

테스트 계정으로 수행된 거래를 나타냅니다. Google은 이 거래에 요금을 청구하지 않습니다.

OneTimeExternalTransaction

일회성 거래를 나타냅니다.

JSON 표현 
{
  "externalTransactionToken": string
}
필드
externalTransactionToken

string

입력 전용입니다. 생성 호출 중 제공됩니다. 개발자 제공 결제 절차가 시작되면 클라이언트로부터 가져옵니다.

RecurringExternalTransaction

반복되는 일련의 결제에 포함된 거래를 나타냅니다. 정기 결제이거나 여러 건의 결제가 포함된 일회성 제품 (예: 선주문)일 수 있습니다.

JSON 표현 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
필드

통합 필드 source.

source는 다음 중 하나여야 합니다.
initialExternalTransactionId

string

반복되는 일련의 거래 중 첫 번째 거래의 외부 거래 ID입니다. 예를 들어 정기 결제의 경우 첫 결제의 거래 ID가 됩니다. 반복적 외부 거래를 생성할 때 필요합니다.
externalTransactionToken

string

입력 전용입니다. 생성 호출 중 제공됩니다. 개발자 제공 결제 절차가 시작되면 클라이언트로부터 가져옵니다. 첫 구매 시에만 필요합니다.
migratedTransactionProgram

enum (ExternalTransactionProgram)

입력 전용입니다. 생성 호출 중 제공됩니다. 수동 월간 보고에서 자동 보고로 정기 결제를 이전할 때만 사용해야 합니다.
통합 필드 product_details. 필수 항목입니다. 반복되는 외부 거래의 제품 세부정보입니다. product_details은 다음 중 하나여야 합니다.
externalSubscription

object (ExternalSubscription)

외부 정기 결제의 세부정보입니다.
otherRecurringProduct

object (OtherRecurringProduct)

기타 특정 카테고리에 속하지 않는 반복적 외부 거래의 세부정보입니다.

ExternalTransactionProgram

사용자가 거래를 완료하기 위해 거친 외부 거래 프로그램을 나타냅니다.

열거형
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED 거래 프로그램이 지정되어 있지 않습니다. 사용되지 않음.
USER_CHOICE_BILLING 사용자가 Google Play 결제와 개발자 관리 결제 사이에 선택할 수 있는 경우의 사용자 선택 결제입니다.
ALTERNATIVE_BILLING_ONLY 사용자가 개발자-관리자 결제만 사용할 수 있는 경우 개발자 제공 결제만 해당합니다.

ExternalSubscription

외부 정기 결제의 세부정보입니다.

JSON 표현 
{
  "subscriptionType": enum (SubscriptionType)
}
필드
subscriptionType

enum (SubscriptionType)

필수 항목입니다. 외부 정기 결제의 유형입니다.

SubscriptionType

외부 정기 결제의 유형입니다.

열거형
SUBSCRIPTION_TYPE_UNSPECIFIED 지정되지 않았으므로 사용하지 마세요.
RECURRING 결제 주기마다 사용자에게 요금이 부과되는 반복적 정기 결제입니다.
PREPAID 사용자가 미리 결제하는 선불 정기 결제입니다.

OtherRecurringProduct

이 유형에는 필드가 없습니다.

기타 특정 카테고리에 속하지 않는 반복적 외부 거래의 세부정보입니다.

TransactionState

이루어진 거래의 상태입니다.

열거형
TRANSACTION_STATE_UNSPECIFIED 거래 상태가 지정되어 있지 않습니다. 사용되지 않음.
TRANSACTION_REPORTED 거래가 성공적으로 Google에 보고되었습니다.
TRANSACTION_CANCELED 거래가 완전히 환불되었습니다.

ExternalTransactionAddress

외부 거래를 위한 사용자의 주소입니다.

JSON 표현 
{
  "regionCode": string,
  "administrativeArea": string
}
필드
regionCode

string

필수 항목입니다. ISO-3166-1 Alpha-2에 따른 두 글자 지역 코드입니다 (UN 지역 코드).
administrativeArea

string

선택사항입니다. 국가/지역의 최상위 수준 관리 하위 분류입니다. 인도에서 이루어지는 거래에만 필요합니다. 유효한 값은 'ANDAMAN AND NICOBAR ISLANDS', 'ANDHRA PRADESH', 'ARUNACHAL PRADESH', 'ASSAM', 'BIHAR', 'CHANDIGARH', 'CHHATTISGARH', 'DADRA AND NAGAR HAVELI', 'DADRA AND NAGAR HAVELI AND DAMAN AND DIU', 'DAMAN AND DIU', 'DELHI', 'GOA', 'GUJARAT', 'HARYANA', 'HIMACHAL PRADESH', 'JAMMU AND KASHMIR', 'JHARKHAND', 'KARNATAKA', 'KERALA', 'LADAKH', 'LAKSHADWEEP', 'MADHYA PRADESH', 'MAHARASHTRA', 'MANIPUR', 'MEGHALAYA', 'MIZORAM', 'NAGALAND', 'ODISHA', 'PUDUCHERRY', 'PUNJAB', 'RAJASTHAN', 'SIKKIM', 'TAMIL NADU', 'TELANGANA', 'TRIPURA', 'UTTAR PRADESH', 'UTTARAKHAND', 'WEST BENGAL'입니다.

ExternalOfferDetails

외부 제안 프로그램에만 해당하는 보고 세부정보입니다.

JSON 표현 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
필드
installedAppPackage

string

선택사항입니다. 이 거래를 통해 다운로드된 앱의 패키지 이름입니다. linkType이 LINK_TO_APP_DOWNLOAD인 경우 필수입니다.
installedAppCategory

enum (ExternalOfferAppCategory)

선택사항입니다. 이 거래를 통해 다운로드된 앱의 카테고리입니다. 이는 외부 앱 인증 절차 중에 Play Console에 제공된 카테고리와 일치해야 합니다. 앱 다운로드에만 필요합니다.
appDownloadEventExternalTransactionId

string

선택사항입니다. 외부 링크를 통한 앱 다운로드 이벤트와 연결된 외부 거래 ID입니다. 외부에 설치된 앱에서 이루어진 거래를 보고할 때 필요합니다.

ExternalOfferLinkType

외부 링크 유형입니다.

열거형
LINK_TO_DIGITAL_CONTENT_OFFER 디지털 콘텐츠 구매 제안입니다.

ExternalOfferAppCategory

다운로드한 앱의 카테고리입니다. 앱 카테고리에 관한 자세한 내용은 https://support.google.com/googleplay/android-developer/answer/9859673을 참고하세요.

열거형
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED 지정되지 않았으므로 사용하지 마세요.
APP 앱이 앱 카테고리로 분류됩니다.
GAME 앱이 게임 카테고리로 분류됩니다.

메서드

createexternaltransaction

 새 외부 거래를 만듭니다.

getexternaltransaction

 기존 외부 거래를 가져옵니다.

refundexternaltransaction

 기존 외부 거래를 환불하거나 부분 환불합니다.

오류 코드

이 리소스의 작업은 다음 HTTP 오류 코드를 반환합니다.

오류 코드 이유 해상도
5xx Google Play 서버의 일반 오류입니다. 요청을 다시 시도하세요.

문제가 계속되면 Google Play 계정 관리자에게 문의하거나 지원 요청을 제출하세요. Play 상태 대시보드에서 알려진 서비스 중단이 있는지 확인해 보세요.
409 동시 실행 업데이트 오류입니다.

업데이트 중인 객체를 업데이트하려고 시도했습니다. 예를 들어 Play 결제 라이브러리의 acknowledgePurchase() 메서드를 호출하고 Play Developer API의 purchases.products.acknowledge를 동시에 호출하여 구매가 확인됩니다.

 요청을 다시 시도하세요.