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 Clips を一覧表示します。

フラグ	必須	説明
--app-id	はい	App Store Connect のアプリ 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 Clip

• id — App Clip ID
• appId — 親アプリの ID（リクエストから挿入され、API からは返されません）
• bundleId — App Clip のバンドル ID（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 を参照してください。