asc-app-clips

使用 asc 管理 App Clips

通过 App Store Connect API 管理 App Clips、其默认体验和特定语言区域的卡片内容。

身份验证

asc auth login --key-id <id> --issuer-id <id> --private-key-path ~/.asc/AuthKey.p8

导航方式（CAEOAS 可操作项）

每个 JSON 响应都包含一个 "affordances" 字段，其中提供了可直接运行的命令——所需 ID 已填入。从 App Clip 开始，依次导航到体验和本地化内容。

{
  "id": "clip-abc",
  "appId": "6443417124",
  "bundleId": "com.example.MyApp.Clip",
  "affordances": {
    "listAppClips": "asc app-clips list --app-id 6443417124",
    "listExperiences": "asc app-clip-experiences list --app-clip-id clip-abc"
  }
}

常见工作流

设置 App Clip 体验和本地化内容

# 1. Find the App Clip for your app
asc app-clips list --app-id 6443417124 --pretty

# 2. Create a default experience (copy --app-clip-id from the listExperiences affordance)
asc app-clip-experiences create \
  --app-clip-id clip-abc \
  --action OPEN \
  --pretty

# 3. Add an English localization (copy --experience-id from the listLocalizations affordance)
asc app-clip-experience-localizations create \
  --experience-id exp-xyz \
  --locale en-US \
  --subtitle "Order faster with your loyalty card" \
  --pretty

# 4. Add a French localization
asc app-clip-experience-localizations create \
  --experience-id exp-xyz \
  --locale fr-FR \
  --subtitle "Commandez plus vite avec votre carte" \
  --pretty

# 5. Review all localizations
asc app-clip-experience-localizations list --experience-id exp-xyz --output table

一目了然地查看所有 App Clip 内容

CLIP_ID=$(asc app-clips list --app-id APP_ID | jq -r '.data[0].id')
asc app-clip-experiences list --app-clip-id "$CLIP_ID" --output table

EXP_ID=$(asc app-clip-experiences list --app-clip-id "$CLIP_ID" | jq -r '.data[0].id')
asc app-clip-experience-localizations list --experience-id "$EXP_ID" --output table

命令

asc app-clips list

列出某个 App 的所有 App Clips。

标志	必填	说明
--app-id	是	App Store Connect App ID
--output table|json	否	输出格式（默认为 json）
--pretty	否	美化输出 JSON

asc app-clips list --app-id 6443417124 --pretty
asc app-clips list --app-id 6443417124 --output table

asc app-clip-experiences list

列出 App Clip 的默认体验。

标志	必填	说明
--app-clip-id	是	App Clip ID
--output table|json	否	输出格式
--pretty	否	美化输出 JSON

asc app-clip-experiences list --app-clip-id clip-abc --pretty

asc app-clip-experiences create

为 App Clip 创建默认体验。

标志	必填	说明
--app-clip-id	是	App Clip ID
--action	否	OPEN、VIEW 或 PLAY
--output table|json	否	输出格式
--pretty	否	美化输出 JSON

asc app-clip-experiences create --app-clip-id clip-abc --action OPEN --pretty
asc app-clip-experiences create --app-clip-id clip-abc  # no action

asc app-clip-experiences delete

删除默认体验。

标志	必填	说明
--experience-id	是	要删除的体验 ID

asc app-clip-experiences delete --experience-id exp-xyz

asc app-clip-experience-localizations list

列出默认体验的本地化内容。

标志	必填	说明
--experience-id	是	体验 ID
--output table|json	否	输出格式
--pretty	否	美化输出 JSON

asc app-clip-experience-localizations list --experience-id exp-xyz --pretty

asc app-clip-experience-localizations create

为默认体验创建本地化内容。每种语言区域都有自己的副标题，显示在 App Clip 卡片上。

标志	必填	说明
--experience-id	是	体验 ID
--locale	是	语言区域代码（例如 en-US、fr-FR、zh-Hans）
--subtitle	否	显示在 App Clip 卡片上的副标题
--output table|json	否	输出格式
--pretty	否	美化输出 JSON

asc app-clip-experience-localizations create \
  --experience-id exp-xyz \
  --locale en-US \
  --subtitle "Order faster with your loyalty card"

asc app-clip-experience-localizations delete

删除本地化内容。

标志	必填	说明
--localization-id	是	要删除的本地化 ID

asc app-clip-experience-localizations delete --localization-id loc-abc

领域模型

AppClip — 与某个 App 关联的 App Clip

• id — App Clip ID
• appId — 父级 App ID（从请求中注入，API 不会返回）
• bundleId — App Clip 的 bundle 标识符（如果为 nil，则从 JSON 中省略）
• 可操作项：listAppClips、listExperiences

AppClipDefaultExperience — App Clip 的调用方式

• id — 体验 ID
• appClipId — 父级 App Clip ID（注入）
• action — OPEN、VIEW 或 PLAY（如果为 nil，则从 JSON 中省略）
• 可操作项：delete、listExperiences、listLocalizations

AppClipDefaultExperienceLocalization — 特定语言区域的 App Clip 卡片内容

• id — 本地化 ID
• experienceId — 父级体验 ID（注入）
• locale — 语言区域代码（例如 en-US）
• subtitle — 显示在 App Clip 卡片上的副标题（如果为 nil，则从 JSON 中省略）
• 可操作项：delete、listLocalizations

完整命令参考

所有标志和示例请参阅 commands.md。