2026.08.08

【Google】アプリ内課金の注文情報(orders)を取得する

saratogax

記事内に商品プロモーションを含む場合があります

Google Play のアプリ内課金には、購入によって発生した「注文(Order)」の情報を扱う API が用意されています。

定期購入や 1 回限りの購入の状態を見る API とは別に、注文という単位で取引の情報を取得できるのが特徴です。

このページでは、注文情報(orders)で何が取得できるのか、その全体像をまとめていきます。

アプリ内課金全体の中での位置づけは、以下のまとめページもあわせてご覧ください。

注文情報(orders)とは

注文情報(orders)は、Google Play 上で行われた 1 回の取引をまとめて表す情報です。

定期購入の状態は purchases.subscriptionsv2.get、1 回限りの購入の状態は purchases.products.get で確認します。

ですが、これらは「いま購入がどういう状態か」を見るための API です。

一方の注文情報は、金額・税・返金・購入者の所在地といった、取引そのものの情報を扱います。

注文情報は、売上の集計や返金状況の把握、注文履歴の照合など、購入の「状態管理」とは別の用途で役立つ API です。

注文情報を取得すると、Order というリソースが返ります。

Order には、おもに次のような情報が含まれます。

フィールド	内容
orderId	注文ID
purchaseToken	購入時にユーザーの端末へ渡される購入トークン
state	注文の状態
createTime	注文が作成された日時
lastEventTime	注文に最後の変更が加わった日時
lineItems	注文に含まれる個々の商品
total / tax	支払い総額と税額
developerRevenueInBuyerCurrency	購入者の通貨建てのデベロッパー収益(部分返金・税・手数料を差し引いた後の金額)
buyerAddress	購入者の所在地情報(国・地域・郵便番号など)
orderHistory	返金やキャンセルなど、注文に加わったイベントの履歴

※表は横スクロールできます

1 つの注文に、金額・税・履歴までまとまっているのがポイントです。

なお total は購入者が支払った総額で、developerRevenueInBuyerCurrency はそこから手数料や税が引かれた手取りの金額です。

売上を集計するときは、この 2 つを取り違えないよう注意してください。

注文の state には、取引の進み具合を表す値が入ります。

※表は横スクロールできます

注文情報は、Google Play Developer API の orders リソースから取得します。

取得方法は、用途に応じて 2 つあります。

メソッド	内容
orders.get	注文IDを 1 つ指定して、その注文の詳細を取得する
orders.batchget	注文IDを複数(1〜1000 件)指定して、まとめて取得する

※表は横スクロールできます

多数の注文を扱う場合は、1 件ずつ呼び出すよりも orders.batchget でまとめて取得する方が効率的です。

注文情報の API は、購入の状態を管理する API とは役割が異なります。

API	主な用途
subscriptionsv2.get / products.get	購入トークンから、購入が「いまどういう状態か」を確認する
orders.get / orders.batchget	注文IDから、金額・税・返金・履歴といった取引情報を取得する

※表は横スクロールできます

コンテンツへのアクセス権を付与・剥奪する判断は、これまでどおり購入トークン系の API で行います。

注文情報は、その取引が「いくらで、いつ、どう返金されたか」を後から把握したいときに活躍します。