asc-review-detail

asc version-review-detail

バージョンのApp Storeレビュー情報（連絡先情報＋デモアカウント）を管理します。提出前に設定する必要があります。問題が発生した場合にApp Reviewチームから連絡できるよう、連絡先情報が必要です。

コマンド

get — 現在のレビュー情報を取得

asc version-review-detail get --version-id <VERSION_ID> [--pretty]

レビュー情報が一度も設定されていない場合は、空のレコード（id: ""）を返します。

update — レビュー情報を設定または更新（アップサート）

asc version-review-detail update --version-id <VERSION_ID> \
  [--contact-first-name <name>] \
  [--contact-last-name <name>] \
  [--contact-phone <phone>] \
  [--contact-email <email>] \
  [--demo-account-required <true|false>] \
  [--demo-account-name <username>] \
  [--demo-account-password <password>] \
  [--notes <text>]

アップサート： レコードが存在しない場合は新しいレコードを作成し（POST）、存在する場合は既存のレコードにパッチを適用します（PATCH）。指定されたフラグのみ送信されるため、既存のレコードで指定されていないフィールドは変更されません。

提出前の一般的なワークフロー

# 1. Check what's currently set
asc version-review-detail get --version-id <VERSION_ID> --pretty

# 2. Set contact info (minimum to clear reviewContactCheck warning)
asc version-review-detail update --version-id <VERSION_ID> \
  --contact-first-name Jane \
  --contact-email [email protected] \
  --contact-phone "+1-555-0100"

# 3. If app requires a demo account
asc version-review-detail update --version-id <VERSION_ID> \
  --demo-account-required true \
  --demo-account-name demo_user \
  --demo-account-password "secret" \
  --notes "Tap 'Sign In' then use the credentials above"

# 4. Verify check-readiness passes reviewContactCheck
asc versions check-readiness --version-id <VERSION_ID> --pretty

# 5. Submit
asc versions submit --version-id <VERSION_ID>

JSON出力形式

{
  "data": [
    {
      "affordances": {
        "getReviewDetail":    "asc version-review-detail get --version-id <id>",
        "updateReviewDetail": "asc version-review-detail update --version-id <id>"
      },
      "contactEmail": "[email protected]",
      "contactFirstName": "Jane",
      "contactLastName": "Smith",
      "contactPhone": "+1-555-0100",
      "demoAccountRequired": false,
      "id": "rd-abc123",
      "versionId": "<VERSION_ID>"
    }
  ]
}

Nilのオプションフィールド（contactFirstName、contactEmail、demoAccountName、notesなど）はJSON出力から省略されます。

check-readinessのreviewContactCheckを読む

"reviewContactCheck": { "pass": false, "message": "Review contact info is missing" }

これは修正推奨の警告であり、isReadyToSubmitをブロックすることはありません。次のように修正します。

# Copy updateReviewDetail affordance from version-review-detail get output
asc version-review-detail update --version-id <id> --contact-email [email protected] --contact-phone "+1-555-0100"

主な計算プロパティ

プロパティ	ロジック
hasContact	contactEmail != nil && contactPhone != nil
demoAccountConfigured	!demoAccountRequired || (name != nil && password != nil)

hasContactはasc versions check-readinessのreviewContactCheck.passに反映されます。

CAEOASのアフォーダンス

AppStoreVersionにはgetReviewDetailが含まれています。バージョン一覧のどれからでも、これをたどることができます。

VERSION=$(asc versions list --app-id "$APP_ID" | jq -r '.data[0]')
eval "$(echo "$VERSION" | jq -r '.affordances.getReviewDetail') --pretty"