Object

ConsumptionRequest

消費情報を含む要求本文。

App Store Server API 1.0+

object ConsumptionRequest

プロパティ

accountTenure accountTenure	(必須) 顧客のアカウントの年齢。
appAccountToken appAccountToken	(必須) アプリ内購入取引を完了したアプリ内ユーザアカウントの UUID。
consumptionStatus consumptionStatus	(必須) 顧客がアプリ内購入をどの程度の量消費したかを示す値。
customerConsented customerConsented	(必須) 顧客が消費データの提供に同意したかどうかを示す true または false のブール値。注: App Store サーバは、true 以外の consumptionStatus 値を持つ要求を拒否し、InvalidCustomerConsentError を含む HTTP 400 エラーを返します。
deliveryStatus deliveryStatus	(必須) アプリが適切に機能するアプリ内購入を正常に配信したかどうかを示す値。
lifetimeDollars Purchased lifetimeDollars Purchased	(必須) すべてのプラットフォームで顧客があなたのアプリ内で行ったアプリ内購入の合計金額 (USD) を示す値。
lifetimeDollars Refunded lifetimeDollars Refunded	(必須) あなたのアプリ内のすべてのプラットフォームで顧客が受け取った払い戻しの合計金額 (USD) を示す値。
platform platform	(必須) 顧客がアプリ内購入で消費したプラットフォームを示す値。
playTime playTime	(必須) 顧客がアプリを使用した時間の量を示す値。
refundPreference refundPreference	あなたの運用論理に基づいて、Apple が払い戻しを許可するかどうかの設定を示す値。
sampleContent Provided sampleContent Provided	(必須) 購入前にコンテンツの無料サンプルや試用版、またはその機能の情報をあなたが提供したかどうかを示す true または false のブール値。
userStatus userStatus	(必須) 顧客のアカウントのステータス。

以下で言及

App Store サーバ API の変更履歴

議論

ConsumptionRequest を使用して、Send Consumption Information エンドポイントを呼び出すときに、顧客の消耗品のアプリ内購入または自動更新サブスクリプションに関する情報を提供します。

有効な要求を作成し、HTTP 400 Bad Request エラーを回避するには、ConsumptionRequest に適切なデータ型と有効な値を持つすべての必須フィールドが含まれていなければなりません。ただし、ほとんどのフィールドでは、情報を提供するかどうかをあなたが選択できます。ほとんどのフィールドには、情報を提供しないことを選択した場合に有効なオプションがあります。

注意

情報を提供しない事を選択した場合は、利用可能な場合は、undeclared (未宣言) のフィールド値を使用します。

たとえば、accountTenure フィールドに情報を提供しない事を選択した場合は、accountTenure を 0 に設定します。appAccountToken フィールドに情報を提供しない事を選択した場合は、その値を空の文字列に設定します。有効な値のリストについては、各フィールドのドキュメントを参照してください。宣言されていない値がある場合は、その値も含みます。

App Store サーバは、customerConsented 値が true 以外の要求を拒否し、InvalidCustomerConsentError とともに HTTP 400 エラーを返します。