asc-review-detail

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

asc version-review-detail

Manage App Store review information (contact details + demo account) for a version. Required before submission — the App Review team needs contact info to reach you if there's an issue.

管理某一版本的App Store审核信息（联系详情+演示账户）。提交应用前必须完成此项配置——若审核过程中出现问题，App审核团队需要通过联系信息与您取得联系。

Commands

命令

get — fetch current review info

get — 获取当前审核信息

bash

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

Returns an empty record (

id: ""

) when review info has never been set.

bash

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

若从未设置过审核信息，将返回空记录（

id: ""

）。

update — set or update review info (upsert)

update — 设置或更新审核信息（插入或更新）

bash

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>]

Upsert: Creates a new record if none exists (POST), patches the existing one if it does (PATCH). Only supplied flags are sent — unspecified fields are left unchanged on an existing record.

bash

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>]

插入或更新（Upsert）：若不存在记录则创建新记录（POST请求），若已存在则更新现有记录（PATCH请求）。仅会发送指定的参数——未指定的字段将保留现有记录中的值。

Typical Pre-Submission Workflow

典型的提交前工作流

bash

undefined

bash

undefined

1. Check what's currently set

1. 查看当前已配置的信息

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

2. Set contact info (minimum to clear reviewContactCheck warning)

2. 设置联系信息（满足最小要求以清除reviewContactCheck警告）

asc version-review-detail update --version-id <VERSION_ID>
--contact-first-name Jane
--contact-email dev@example.com
--contact-phone "+1-555-0100"

3. If app requires a demo account

3. 若应用需要演示账户

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

4. 验证check-readiness中的reviewContactCheck是否通过

asc versions check-readiness --version-id <VERSION_ID> --pretty

5. Submit

5. 提交应用

asc versions submit --version-id <VERSION_ID>

undefined

asc versions submit --version-id <VERSION_ID>

undefined

JSON Output Shape

JSON输出格式

json

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

Nil optional fields (

contactFirstName

contactEmail

demoAccountName

notes

, etc.) are omitted from JSON output.

json

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

可选字段（如

contactFirstName

、

contactEmail

、

demoAccountName

、

notes

等）若为null，将不会出现在JSON输出中。

Reading reviewContactCheck in check-readiness

在check-readiness中查看reviewContactCheck结果

json

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

This is a SHOULD FIX warning — it does NOT block

isReadyToSubmit

. Fix it with:

bash

undefined

json

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

这是一个建议修复的警告——它不会阻止

isReadyToSubmit

。可通过以下命令修复：

bash

undefined

Copy updateReviewDetail affordance from version-review-detail get output

从version-review-detail get的输出中复制updateReviewDetail命令

asc version-review-detail update --version-id <id> --contact-email dev@example.com --contact-phone "+1-555-0100"

undefined

asc version-review-detail update --version-id <id> --contact-email dev@example.com --contact-phone "+1-555-0100"

undefined

Key Computed Properties

关键计算属性

Property	Logic
`hasContact`	`contactEmail != nil && contactPhone != nil`
`demoAccountConfigured`	`!demoAccountRequired \|\| (name != nil && password != nil)`

hasContact

feeds

reviewContactCheck.pass

asc versions check-readiness

属性	逻辑
`hasContact`	`contactEmail != nil && contactPhone != nil`
`demoAccountConfigured`	`!demoAccountRequired \

hasContact

的值会影响

asc versions check-readiness

中

reviewContactCheck.pass

的结果。

CAEOAS Affordances

CAEOAS 关联操作（Affordances）

AppStoreVersion

includes

getReviewDetail

— follow it from any version listing:

bash

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

AppStoreVersion

包含

getReviewDetail

操作——可从任何版本列表中调用该操作：

bash

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