Purchase

このリファレンスドキュメントには、Purchaseクラスとそのメソッドの詳細が記載されています。

    public class Purchase extends Object 
        
        java.lang.Object
            gg.now.billingclient.api.Purchase

詳細

PurchaseはPurchasesResultクラスの一部で、アプリ内課金に使用されます。

パブリックコンストラクター

    Purchase

     Purchase (String jsonPurchaseInfo, String signature)

                            throws JSONException

パラメータ	説明	スロー
jsonPurchaseInfo	String	jSONException
signature	String

パブリックメソッド

	説明	使用方法
boolean	equals(object o)	`boolean gg.now.billingclient.api.Purchase.equals (Object o)`
String	getOrderId() – トランザクション用の固有識別子を返します	`String gg.now.billingclient.api.Purchase.getOrderId()`
String	getOriginalJson() – 購入注文の詳細を含む文字列をJSONで返します. こちらで詳しく確認できます.	`String gg.now.billingclient.api.Purchase.getOriginalJson()`
String	getPackageName() – 購入元のアプリケーションパッケージを返します	`String gg.now.billingclient.api.Purchase.getPackageName()`
long	getPurchaseTime() – 購入時間を返します	`long gg.now.billingclient.api.Purchase.getPurchaseTime()`
String	getPurchaseToken() – 固有の識別子購入トークンを返します	`String gg.now.billingclient.api.Purchase.getPurchaseToken()`
String	getSignature() – 開発者のプライベートキーを使用して署名された購入署名を含む文字列を返します	`String gg.now.billingclient.api.Purchase.getSignature()`
String	getSku() – Product IDを返します	`String gg.now.billingclient.api.Purchase.getSku()`
int	hashCode()	`int gg.now.billingclient.api.Purchase.hashCode()`
boolean	isAutoRenewing() – 購入が自動更新されるかどうかを返します。	`boolean gg.now.billingclient.api.Purchase.isAutoRenewing()`
String	getSubscriptionPeriod() – ISO 8601形式で指定された定期購読期間を返します。詳細はこちらを参照してください。	`String gg.now.billingclient.api.Purchase.getSubscriptionPeriod()`
long	getExpiryTimeMillis() – 定期購読の有効期限時刻（ミリ秒単位）を返します。	`long gg.now.billingclient.api.Purchase.getExpiryTimeMillis()`
long	getSubscriptionPurchaseDateMillis() – 定期購読の購入日付を返します。	`long gg.now.billingclient.api.Purchase.getSubscriptionPurchaseDateMillis()`
String	getSubscriptionStatus() – 定期購読の状態を返します – ここで定義されています。	`String gg.now.billingclient.api.Purchase.getSubscriptionStatus()`
boolean	isAcknowledged() – 購入が承認されたかどうかを返します。	`boolean gg.now.billingclient.api.Purchase.isAcknowledged()`
String	toString()	`String gg.now.billingclient.api.Purchase.toString()`
String	getDeveloperPayload() – 注文に関する補足情報を含む開発者指定の文字列。	`String gg.now.billingclient.api.Purchase.getDeveloperPayload()`

getOriginalJson() レスポンス

以下は、getOriginalJson() の想定レスポンスです。

重要な情報

このレスポンス内の一部のフィールドは、サブスクリプション購入の場合にのみ返され、買い切り型商品の場合は含まれません。

 {
   "productId": "coin_2000",
   "purchaseTime": 1770103123400,
   "developerPayload": "<developerPayload here>",
   "purchaseToken": "<purchaseToken here>.",
   "orderId": "1-2026020111116395992244",
   "packageName": "gg.now.sample.app",

   "subscriptionStatus": "CANCELLED",
   "subscriptionPeriod": "P1W",
   "expiryTimeMillis": 1755505803000,
   "subscriptionPurchaseDateMillis": 1754901003000,
   "isAcknowledged": false,
   "autoRenewing": true
 }

レスポンスパラメータ

getOriginalJson() に関連するレスポンスパラメータは次のとおりです。

パラメータ	型	説明
`productId`	string	購入された商品またはサブスクリプションを識別する一意の ID です。
`purchaseTime`	int	購入完了時刻を、UTC のエポック以降のミリ秒で表した値です。
`developerPayload`	string	購入に関連付けられた、開発者が任意に定義できるメタデータです。
`purchaseToken`	string	購入を表すトークンです。購入検証のため、このトークンをバックエンドに送信する必要があります。注意: now.gg の購入トークンは通常 `-nowgg-` で始まります。
`orderId`	string	トランザクションに関連付けられた一意の注文 ID です。
`packageName`	string	購入が発生したアプリのパッケージ名です。
`subscriptionStatus`	string	サブスクリプションの現在のステータスです。サブスクリプションの場合のみ有効です。例: `ACTIVE`, `CANCELLED`, `EXPIRED`.
`subscriptionPeriod`	string	ISO-8601 形式で表されたサブスクリプション期間です。サブスクリプションの場合のみ有効です。例: `P1W` (1 週間), `P1M` (1 か月)。
`expiryTimeMillis`	int	サブスクリプションの有効期限を、UTC のエポック以降のミリ秒で表した値です。サブスクリプションの場合のみ有効です。
`subscriptionPurchaseDateMillis`	int	サブスクリプションが最初に購入された時刻を、UTC のエポック以降のミリ秒で表した値です。サブスクリプションの場合のみ有効です。
`isAcknowledged`	boolean	サブスクリプション購入が承認 (acknowledge) されたかどうかを示します。サブスクリプションの場合のみ有効です。
`autoRenewing`	boolean	サブスクリプションが自動更新に設定されているかどうかを示します。サブスクリプションの場合のみ有効です。

getSubscriptionStatus Definition

Possible Returns	Description
PENDING	注文は作成されましたが、支払いは保留中です。
EXPIRED	定期購読の更新に失敗しました。
ACTIVE	支払いが完了し、定期購読がアクティブです。
DELETED	開発者はnowStudioから定期購読を削除しました。
CANCELLED	ユーザーが定期購読をキャンセルしました。