REST Resource: purchases.voidedpurchases

リソース: VoidedPurchase

VoidedPurchase リソースは、キャンセル、払い戻し、またはチャージバックが行われた購入を示します。

JSON 表現 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
フィールド
kind

string

この kind は、androidpublisher サービス内の、無効になった購入オブジェクトを表します。
purchaseToken

string

1 回だけの購入か定期購入かを一意に識別するトークン。定期購入の更新を一意に識別するには、orderId を使用します（API のバージョン 3 以降で利用可能）。
purchaseTimeMillis

string (int64 format)

購入が行われた日時。エポック（1970 年 1 月 1 日）からのミリ秒単位の経過時間で示します。
voidedTimeMillis

string (int64 format)

購入がキャンセル、払い戻し、またはチャージバックされた日時。エポック（1970 年 1 月 1 日）からのミリ秒単位の経過時間で示します。
orderId

string

1 回だけの購入、定期購入、定期購入の更新を一意に識別するオーダー ID。
voidedSource

integer

購入を無効にした主体。値は次のいずれかです。0. ユーザー 1。デベロッパー 2. Google
voidedReason

integer

購入が無効になった理由。値は次のいずれかです。0. その他 1. 購入者都合 2. 受領していない 3. 欠陥がある 4. 誤って購入した 5. 不正行為 6. 意図しない購入 7. チャージバック 8. Unacknowledged_purchase
voidedQuantity

integer

数量ベースの一部払い戻しの結果無効になった数量。数量ベースの一部払い戻しで無効になった購入は、includeQuantityBasedPartialRefund が true に設定されている場合にのみ返せます。

メソッド

list

 キャンセル、払い戻し、またはチャージバックされた購入のリストを作成します。

エラーコード

このリソースのオペレーションは、次の HTTP エラーコードを返します。

エラーコード 理由 説明 解決策
400 invalidValue リクエストで無効な値が指定されました。多くの場合、これは形式が正しくないか無効な購入トークンに対して返されます。 API リファレンスに基づいて、リクエスト本文またはパラメータの無効なフィールド値を修正します。
400 required リクエストに必須のフィールドまたはパラメータがありません。 API のドキュメントを参照して、すべての必須フィールドとパラメータが含まれていることを確認します。
403 userInsufficientPermission リクエストされたオペレーションを実行する権限がユーザーにありません。 認証済みユーザーが Google Play Console で必要な権限を持っていることを確認します。詳細については、 サービス アカウントの使用をご覧ください。
404 notFound リクエストされたリソースが見つかりませんでした。 ID（購入トークン、パッケージ名、商品 ID、定期購入 ID など）が正しいことを確認します。
409 concurrentUpdate 同時に更新されているオブジェクトを更新しようとしました。 指数バックオフを使用してリクエストを再試行します。同じリソースへの同時変更は避けてください。
5xx Generic error Google Play サーバーの一般的なエラー。 リクエストを再試行してください。

問題が解決しない場合は、Google Play アカウント マネージャーにお問い合わせいただくか、サポート リクエストを送信してください。Google Play ステータス ダッシュボードで、既知のサービス停止がないか確認してください。