- リソース: ExternalTransaction
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- RecurringExternalTransaction
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ExternalTransactionProgram
- ExternalSubscription
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ExternalOfferInitialAcquisitionDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- メソッド
リソース: ExternalTransaction
外部取引の詳細。
JSON 表現 |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
フィールド | |
---|---|
packageName |
出力専用。外部トランザクションのリソース名。アプリ内アイテムが販売されたアプリのパッケージ名(「com.some.app」など)。 |
externalTransactionId |
出力専用。この取引の ID。同じパッケージ名のすべてのトランザクション ID は一意である必要があります。外部トランザクションの作成時に設定します。 |
originalPreTaxAmount |
必須。元の取引金額(税抜き)。これは、払い戻しが適用される前に Google に通知された税抜きの金額です。 |
originalTaxAmount |
必須。元の税額。払い戻しが適用される前に Google に通知された税額を表します。 |
currentPreTaxAmount |
出力専用。現在の取引金額(税抜き)。これは、この取引に適用された可能性のある払い戻しを含む、現在の税抜きの金額を表します。 |
currentTaxAmount |
出力専用。現在の税額。これは、この取引に適用された可能性のある払い戻しを含む現在の税額を表します。 |
testPurchase |
出力専用。設定されている場合、この取引はテスト購入です。Google がテスト取引について請求することはありません。 |
transactionTime |
必須。トランザクションが完了した時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
createTime |
出力専用。このトランザクションが作成された時刻。これは、Google に取引が通知された時刻です。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
transactionState |
出力専用。トランザクションの現在の状態。 |
userTaxAddress |
必須。税額を計算するユーザーの住所。 |
transactionProgramCode |
省略可。パートナー プログラムに参加している対象アプリのサービス手数料を決定する際に使用するトランザクション プログラム コード。Google Play メディア エクスペリエンス プログラム(https://play.google.com/console/about/programs/mediaprogram/)に参加しているデベロッパーは、代替の課金システムの取引を報告する際にプログラム コードを提供する必要があります。対象となるデベロッパーの方は、このフィールドの設定方法の詳細については、BDM にお問い合わせください。注: このフィールドは外部提案の取引には使用できません。 |
externalOfferInitialAcquisitionDetails |
省略可。ユーザーまたはデバイスが外部提案を使用して初めて取引を完了した時点の詳細。ユーザー選択型決済または代替の課金システムのみを使用して行われる取引では不要です。 |
共用体フィールド transaction_type 。実行されたトランザクションの種類。transaction_type は次のいずれかになります。 |
|
oneTimeTransaction |
この取引は 1 回限りの取引であり、定期購入の一部ではありません。 |
recurringTransaction |
この取引は、繰り返し行われる一連の取引の一部です。 |
ExternalTransactionTestPurchase
この型にはフィールドがありません。
テスト アカウントを使用して実行されたトランザクションを表します。これらの取引が Google から請求されることはありません。
OneTimeExternalTransaction
1 回限りのトランザクションを表します。
JSON 表現 |
---|
{ "externalTransactionToken": string } |
フィールド | |
---|---|
externalTransactionToken |
入力のみのCreate の呼び出し時に指定します。代替の課金システムのフローが開始されたときにクライアントから取得されます。 |
RecurringExternalTransaction
定期的な支払いに含まれる取引を表します。定期購入の場合もあれば、複数の支払いを伴う 1 回限りのアイテム(予約購入など)もあります。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド
|
|
initialExternalTransactionId |
この定期的な取引の最初の取引の外部取引 ID。たとえば定期購入の場合、最初の支払いの取引 ID になります。定期的な外部取引を作成する場合は必須です。 |
externalTransactionToken |
入力のみのCreate の呼び出し時に指定します。代替の課金システムのフローが開始されたときにクライアントから取得されます。初回購入の場合のみ必須。 |
migratedTransactionProgram |
入力のみのCreate の呼び出し時に指定します。サブスクリプションを手動の月次レポートから自動レポートに移行する場合にのみ使用してください。 |
共用体フィールド product_details 。必須。定期的な外部取引の商品の詳細。product_details は次のいずれかになります。 |
|
externalSubscription |
外部サブスクリプションの詳細。 |
otherRecurringProduct |
他の特定のカテゴリに属さない、定期的な外部取引商品の詳細。 |
ExternalTransactionProgram
ユーザーがトランザクションを完了するために使用した外部トランザクション プログラムを表します。
列挙型 | |
---|---|
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED |
未指定のトランザクション プログラム。使用されません。 |
USER_CHOICE_BILLING |
ユーザー選択型決済(Google Play 請求サービス(デベロッパーが管理する課金)をユーザーが選択可能) |
ALTERNATIVE_BILLING_ONLY |
代替の課金システムのみ。ユーザーはデベロッパー マネージャーによる請求のみを使用できます。 |
ExternalSubscription
外部サブスクリプションの詳細。
JSON 表現 |
---|
{
"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 |
必須。ISO-3166-1 Alpha-2(UN 地域コード)に基づく 2 文字の地域コード。 |
administrativeArea |
省略可。国または地域の最上位の行政区域。インドでの取引にのみ必要です。 |
ExternalOfferInitialAcquisitionDetails
ユーザーまたはデバイスが外部提案を使用して初めて取引を完了した時点の詳細。
JSON 表現 |
---|
{ "externalTransactionId": string } |
フィールド | |
---|---|
externalTransactionId |
必須。ユーザーが最初に完了した購入の外部取引 ID。 |
メソッド |
|
---|---|
|
新しい外部トランザクションを作成します。 |
|
既存の外部トランザクションを取得します。 |
|
既存の外部取引の払い戻しまたは一部払い戻し。 |