2026.05.21

【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 には、おもに次のような情報が含まれます。

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

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

注文の 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 で行います。

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