asc-iap

asc アプリ内課金

asc CLI で IAP を管理します。

ライフサイクル

一覧表示

asc iap list --app-id <APP_ID> [--limit N] [--pretty]

作成

asc iap create \
  --app-id <APP_ID> \
  --reference-name "Gold Coins" \
  --product-id "com.app.goldcoins" \
  --type consumable

--type ∈ consumable、non-consumable、non-renewing-subscription。

更新

asc iap update --iap-id <ID> \
  [--reference-name "New Name"] \
  [--review-note "Notes for App Review"] \
  [--family-sharable | --not-family-sharable]

削除

asc iap delete --iap-id <ID>

提出／提出取り下げ

asc iap submit --iap-id <ID>          # state must be READY_TO_SUBMIT (affordance gates this)
asc iap unsubmit --submission-id <ID> # withdraw from review; manual Request<Void>
asc iap versions list --iap-id <ID>   # review versions + state; submittable ones offer addToSubmission

初めての IAP ですか？ Apple は IAP をアプリのバージョンと一緒にのみ審査するため、asc iap submit は失敗します。アプリと一緒に提出してください：asc versions submit --version-id <VERSION_ID> --with-products（最初に --dry-run を付けて実行してください）。ワークフロー全体については、submit-with-products.md を参照してください。

IAP の価格設定

asc iap price-points list --iap-id <ID> [--territory USA]

asc iap prices set \
  --iap-id <ID> \
  --base-territory USA \
  --price-point-id <PP>

Apple は基準価格から他の地域の価格を自動調整します。

IAP のローカリゼーション

asc iap-localizations list   --iap-id <ID>
asc iap-localizations create --iap-id <ID> --locale en-US --name "Gold Coins" [--description "In-game currency"]
asc iap-localizations update --localization-id <LOC> [--name "New"] [--description "..."]
asc iap-localizations delete --localization-id <LOC>

IAP オファーコード（3 階層）

レベル 1 — オファーコード

asc iap-offer-codes list   --iap-id <ID>
asc iap-offer-codes create --iap-id <ID> --name "FREEGEMS" \
  --eligibility NON_SPENDER --eligibility CHURNED_SPENDER \
  --price USA=pp-usa --price JPN=pp-jpn \
  --free-territory BRA --free-territory IND
asc iap-offer-codes update --offer-code-id <OC> --active false
asc iap-offer-codes prices list --offer-code-id <OC>   # per-territory pricing (read-only)

価格は作成時に一度だけ設定されます。 ASC の prices リレーションシップはオファーコードの作成後は読み取り専用です。そのため、対象にしたいすべての地域を --price（有料）または --free-territory で指定してください。これらのフラグを指定せずに作成すると、オファーコードには地域別価格が設定されず、後から修正することもできません。

--eligibility（繰り返し指定可能）∈ NON_SPENDER、ACTIVE_SPENDER、CHURNED_SPENDER。

レベル 2 — カスタム引き換えコード

asc iap-offer-code-custom-codes list   --offer-code-id <OC>
asc iap-offer-code-custom-codes create --offer-code-id <OC> \
  --custom-code "FREEGEMS100" --number-of-codes 500 [--expiration-date 2026-12-31]
asc iap-offer-code-custom-codes update --custom-code-id <CC> --active false

レベル 3 — 1 回限り使用できるコードのバッチ

asc iap-offer-code-one-time-codes list   --offer-code-id <OC>
asc iap-offer-code-one-time-codes create --offer-code-id <OC> \
  --number-of-codes 3000 --expiration-date 2026-06-30 [--environment production|sandbox]
asc iap-offer-code-one-time-codes update --one-time-code-id <OTC> --active false

# Download the CSV of redemption codes (raw String — not JSON):
asc iap-offer-code-one-time-codes values --one-time-code-id <OTC>

--environment のデフォルトは production です。Sandbox バッチは Sandbox テスターアカウントで引き換えられます（四半期あたり約 10,000 件が上限）。本番バッチは実際の App Store アカウントで引き換えられます（四半期あたり約 150,000 件が上限）。各 InAppPurchaseOfferCode は productionCodeCount／sandboxCodeCount で両方の上限に対する使用数を報告し、各 1 回限り使用できるコードの行には environment が含まれるため、フィルタリングできます：

asc iap-offer-code-one-time-codes list --offer-code-id <OC> \
  | jq '.data[] | select(.environment == "SANDBOX")'

REST での同等の操作：

GET    /api/v1/iap-offer-codes/{offerCodeId}/one-time-codes
POST   /api/v1/iap-offer-codes/{offerCodeId}/one-time-codes   # body: {numberOfCodes, expirationDate, environment?}
PATCH  /api/v1/iap-offer-code-one-time-codes/{oneTimeCodeId}  # body: {isActive: false}

IAP の審査用アセット

審査用スクリーンショット（シングルトン — IAP ごとに 1 つ）

asc iap-review-screenshot get    --iap-id <ID>          # returns empty data:[] when none uploaded
asc iap-review-screenshot upload --iap-id <ID> --file ./review.png
asc iap-review-screenshot delete --screenshot-id <RS>   # suppressed while assetState == AWAITING_UPLOAD

アップロードでは、ASC 標準の予約 → チャンクのアップロード → MD5 を使用したコミットのプロトコルを使用します。

プロモーション画像（1024×1024、IAP ごとに複数）

asc iap-images list   --iap-id <ID>
asc iap-images upload --iap-id <ID> --file ./promo-1024.png
asc iap-images delete --image-id <IMG>                  # suppressed while state.isPendingReview

CAEOAS の機能

すべての IAP レスポンスには、すぐに実行できる後続コマンドが含まれています：

{
  "affordances": {
    "createLocalization":  "asc iap-localizations create --iap-id <ID> --locale en-US --name <name>",
    "delete":              "asc iap delete --iap-id <ID>",
    "getReviewScreenshot": "asc iap-review-screenshot get --iap-id <ID>",
    "listImages":          "asc iap-images list --iap-id <ID>",
    "listLocalizations":   "asc iap-localizations list --iap-id <ID>",
    "listOfferCodes":      "asc iap-offer-codes list --iap-id <ID>",
    "listPricePoints":     "asc iap price-points list --iap-id <ID>",
    "listVersions":        "asc iap versions list --iap-id <ID>",
    "submit":              "asc iap submit --iap-id <ID>",
    "update":              "asc iap update --iap-id <ID> --reference-name <name>"
  }
}

submit は state == READY_TO_SUBMIT の場合にのみ表示されます。各価格ポイントには、地域が判明している場合にのみ setPrice が含まれます。

InAppPurchaseSubmission には unsubmit が示されます。InAppPurchaseLocalization には update と delete が示されます。InAppPurchasePromotionalImage には !state.isPendingReview の場合にのみ delete が示されます。InAppPurchaseReviewScreenshot には assetState.isComplete || hasFailed の場合にのみ delete が示されます。

App ID の解決

project-context.md を参照してください。ユーザーに尋ねたり asc apps list を実行したりする前に、.asc/project.json を確認してください。

一般的なワークフロー

APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')

# 1. Create + localize
IAP_ID=$(asc iap create --app-id "$APP_ID" --reference-name "Gold Coins" \
  --product-id "com.app.goldcoins" --type consumable | jq -r '.data[0].id')
asc iap-localizations create --iap-id "$IAP_ID" --locale en-US --name "Gold Coins" --description "In-game currency"
asc iap-localizations create --iap-id "$IAP_ID" --locale zh-Hans --name "金币"

# 2. Set price (Tier 1 USA, Apple auto-equalizes)
PRICE_ID=$(asc iap price-points list --iap-id "$IAP_ID" --territory USA \
  | jq -r '.data[] | select(.customerPrice == "0.99") | .id')
asc iap prices set --iap-id "$IAP_ID" --base-territory USA --price-point-id "$PRICE_ID"

# 3. Add review screenshot + promo image
asc iap-review-screenshot upload --iap-id "$IAP_ID" --file ./review.png
asc iap-images upload --iap-id "$IAP_ID" --file ./promo-1024.png

# 4. Submit
asc iap submit --iap-id "$IAP_ID"

# 5. Optional: offer code + redemption batch
OC_ID=$(asc iap-offer-codes create --iap-id "$IAP_ID" --name "LAUNCH_PROMO" \
  --eligibility NON_SPENDER --eligibility CHURNED_SPENDER | jq -r '.data[0].id')
asc iap-offer-code-one-time-codes create --offer-code-id "$OC_ID" \
  --number-of-codes 5000 --expiration-date 2026-12-31
# Download the CSV for distribution:
asc iap-offer-code-one-time-codes values --one-time-code-id <OTC_ID> > codes.csv

状態の意味

InAppPurchaseState は、状態を表すブール値を公開します：

ブール値	状態が次の場合に true
isEditable	MISSING_METADATA、REJECTED、DEVELOPER_ACTION_NEEDED
isPendingReview	WAITING_FOR_REVIEW、IN_REVIEW
isApproved / isLive	APPROVED

IAPCustomerEligibility ∈ NON_SPENDER、ACTIVE_SPENDER、CHURNED_SPENDER。

InAppPurchaseReviewScreenshot.AssetState は isComplete（uploadComplete または complete）と hasFailed を公開します。InAppPurchasePromotionalImage.ImageState は isApproved と isPendingReview を公開します。

値が nil の任意フィールドは JSON 出力から省略されます。

参考資料

ドメインモデルと REST の詳細については、docs/features/iap-subscriptions.md および iap-subscriptions/ の補足ドキュメント を参照してください。