starred/App-Store-Connect-CLI
1
0
Fork 0
mirror of https://github.com/rudrankriyam/App-Store-Connect-CLI.git synced 2026-04-25 23:55:51 +03:00
Code Issues 2 Projects Releases 10 Packages Wiki Activity

[GH-ISSUE #317] Parity: App metadata (keywords, categories, version relationships) #88

New issue
Closed
opened 2026-02-26 21:33:18 +03:00 by kerem · 1 comment
kerem commented 2026-02-26 21:33:18 +03:00
Owner
Copy link

Originally created by @rudrankriyam on GitHub (Jan 30, 2026).
Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/317

Overview

Expand CLI coverage for app metadata endpoints (search keywords, category hierarchy, app info relationships, and app store version relationships) to align with the OpenAPI spec while keeping JSON-first output and explicit flags.

Scope (OpenAPI resources)

  • Apps search keywords: /v1/apps/{id}/searchKeywords, /relationships/searchKeywords
  • App Store versions relationships: age rating, review detail, app clip default experience, experiments v1/v2, submission, customer reviews, routing coverage, alternative distribution package, game center app version
  • App Store version localization search keywords and preview/screenshot set relationships
  • App categories parent/subcategory endpoints
  • App info relationships: categories, age rating, territory age ratings

Proposed CLI

Top-level groups remain:

  • asc apps ...
  • asc versions ...
  • asc localizations ...
  • asc categories ...
  • asc app-info ...

New/expanded subcommands:

  • apps search-keywords list|set --app APP_ID
  • versions get --version-id ID --include age-rating,review-detail,submission,customer-reviews,routing-coverage,app-clip-default-experience
  • versions relationships get --version-id ID --type <relationship> (optional but useful)
  • localizations search-keywords list|add|delete --version-localization-id LOC_ID
  • categories get|parent|subcategories --category-id ID
  • app-info get --app APP_ID --include categories,age-rating,territory-age-ratings

Examples:

  • asc apps search-keywords list --app APP_ID
  • asc apps search-keywords set --app APP_ID --keywords "kw1,kw2"
  • asc versions get --version-id VER_ID --include review-detail,submission
  • asc localizations search-keywords add --version-localization-id LOC_ID --keywords "kw1,kw2"
  • asc categories parent --category-id CAT_ID
  • asc app-info get --app APP_ID --include categories,age-rating

Flag patterns

Common:

  • --app, --version-id, --output, --pretty, --limit, --next, --paginate, --confirm

Resource-specific:

  • --version-localization-id, --category-id, --keywords
  • --include (comma-separated include list)

Output

  • JSON minified by default
  • --pretty for JSON
  • --output table/markdown for list commands

Detailed TODO

  • Add client methods for app search keywords
  • Add client methods for version relationships (age rating, review detail, submission, etc.)
  • Add client methods for localization search keywords + preview/screenshot relationships
  • Add client methods for category parent/subcategories
  • Add client methods for app info relationships (categories, age rating, territory ratings)
  • Implement apps search-keywords commands
  • Implement versions get --include and optional versions relationships
  • Implement localizations search-keywords commands
  • Implement categories parent/subcategories commands
  • Implement app-info get --include ...
  • Add output helpers if needed
  • Add CLI cmdtests and client HTTP tests (mocked)

Acceptance criteria

  • Commands appear in asc apps/versions/localizations/categories/app-info --help
  • Search keywords CRUD works for apps and version localizations
  • Version relationship data can be retrieved via --include or relationships subcommand
  • Category parent/subcategories retrievable
  • App info relationships retrievable
  • Pagination/--next validation works
  • JSON-first output preserved; table/markdown for lists

Tests

  • Command flag validation tests (missing required flags)
  • HTTP client tests for new endpoints
  • Output tests for table/markdown where applicable

Implementation notes

  • Add client methods in internal/asc/client_apps.go, client_versions.go, client_localizations.go, client_categories.go
  • Add CLI handlers in internal/cli/apps, versions, localizations, categories, apps/app_info.go
  • Register in internal/cli/registry/registry.go
  • Follow patterns in existing apps and versions commands
Originally created by @rudrankriyam on GitHub (Jan 30, 2026). Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/317 # Overview Expand CLI coverage for app metadata endpoints (search keywords, category hierarchy, app info relationships, and app store version relationships) to align with the OpenAPI spec while keeping JSON-first output and explicit flags. # Scope (OpenAPI resources) - Apps search keywords: `/v1/apps/{id}/searchKeywords`, `/relationships/searchKeywords` - App Store versions relationships: age rating, review detail, app clip default experience, experiments v1/v2, submission, customer reviews, routing coverage, alternative distribution package, game center app version - App Store version localization search keywords and preview/screenshot set relationships - App categories parent/subcategory endpoints - App info relationships: categories, age rating, territory age ratings # Proposed CLI Top-level groups remain: - `asc apps ...` - `asc versions ...` - `asc localizations ...` - `asc categories ...` - `asc app-info ...` New/expanded subcommands: - `apps search-keywords list|set --app APP_ID` - `versions get --version-id ID --include age-rating,review-detail,submission,customer-reviews,routing-coverage,app-clip-default-experience` - `versions relationships get --version-id ID --type <relationship>` (optional but useful) - `localizations search-keywords list|add|delete --version-localization-id LOC_ID` - `categories get|parent|subcategories --category-id ID` - `app-info get --app APP_ID --include categories,age-rating,territory-age-ratings` Examples: - `asc apps search-keywords list --app APP_ID` - `asc apps search-keywords set --app APP_ID --keywords "kw1,kw2"` - `asc versions get --version-id VER_ID --include review-detail,submission` - `asc localizations search-keywords add --version-localization-id LOC_ID --keywords "kw1,kw2"` - `asc categories parent --category-id CAT_ID` - `asc app-info get --app APP_ID --include categories,age-rating` # Flag patterns Common: - `--app`, `--version-id`, `--output`, `--pretty`, `--limit`, `--next`, `--paginate`, `--confirm` Resource-specific: - `--version-localization-id`, `--category-id`, `--keywords` - `--include` (comma-separated include list) # Output - JSON minified by default - `--pretty` for JSON - `--output table/markdown` for list commands # Detailed TODO - [ ] Add client methods for app search keywords - [ ] Add client methods for version relationships (age rating, review detail, submission, etc.) - [ ] Add client methods for localization search keywords + preview/screenshot relationships - [ ] Add client methods for category parent/subcategories - [ ] Add client methods for app info relationships (categories, age rating, territory ratings) - [ ] Implement `apps search-keywords` commands - [ ] Implement `versions get --include` and optional `versions relationships` - [ ] Implement `localizations search-keywords` commands - [ ] Implement `categories` parent/subcategories commands - [ ] Implement `app-info get --include ...` - [ ] Add output helpers if needed - [ ] Add CLI cmdtests and client HTTP tests (mocked) # Acceptance criteria - [ ] Commands appear in `asc apps/versions/localizations/categories/app-info --help` - [ ] Search keywords CRUD works for apps and version localizations - [ ] Version relationship data can be retrieved via `--include` or relationships subcommand - [ ] Category parent/subcategories retrievable - [ ] App info relationships retrievable - [ ] Pagination/`--next` validation works - [ ] JSON-first output preserved; table/markdown for lists # Tests - Command flag validation tests (missing required flags) - HTTP client tests for new endpoints - Output tests for table/markdown where applicable # Implementation notes - Add client methods in `internal/asc/client_apps.go`, `client_versions.go`, `client_localizations.go`, `client_categories.go` - Add CLI handlers in `internal/cli/apps`, `versions`, `localizations`, `categories`, `apps/app_info.go` - Register in `internal/cli/registry/registry.go` - Follow patterns in existing `apps` and `versions` commands
kerem closed this issue 2026-02-26 21:33:18 +03:00
kerem commented 2026-02-26 21:33:19 +03:00
Author
Owner
Copy link

@rudrankriyam commented on GitHub (Jan 30, 2026):

Closed by #346 (merged).

<!-- gh-comment-id:3825982437 --> @rudrankriyam commented on GitHub (Jan 30, 2026): Closed by #346 (merged).
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
1.2.6
1.2.5
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.1
1.1.0
1.0.1
1.0.0
0.49.1
0.49.0
0.48.1
0.48.0
0.47.1
0.47.0
0.46.2
0.46.1
0.46.0
0.45.4
0.45.3
0.45.2
0.45.1
0.45.0
0.44.2
0.44.1
0.44.0
0.43.0
0.42.0
0.41.4
0.41.3
0.41.2
0.41.1
0.41.0
0.40.1
0.40.0
0.39.1
0.39.0
0.38.3
0.38.2
0.38.1
0.38.0
0.37.3
0.37.2
0.37.1
0.37.0
0.36.3
0.36.2
0.36.1
0.36.0
0.35.3
0.35.2
0.35.1
0.35.0
0.34.1
0.34.0
0.33.2
0.33.1
0.33.0
0.32.0
0.31.3
0.31.2
0.31.1
0.31.0
0.30.0
0.29.3
0.29.2
0.29.1
0.29.0
0.28.14
0.28.13
0.28.12
0.28.11
0.28.10
0.28.9
0.28.8
0.28.7
0.28.6
0.28.5
0.28.4
0.28.3
0.28.2
0.28.1
0.28.0
0.27.0
0.26.4
0.26.3
0.26.2
0.26.1
0.26.0
0.25.4
0.25.3
0.25.1
0.25.0
0.24.3
0.24.2
0.24.1
0.24.0
0.23.5
0.23.4
0.23.3
0.23.2
0.23.1
0.23.0
0.22.1
0.22.0
0.21.0
0.20.2
0.20.1
0.20.0
0.19.3
0.19.2
0.19.1
0.19.0
0.18.2
0.18.1
0.18.0
0.17.0
0.16.0
0.15.0
0.14.0
0.13.0
0.12.4
0.12.3
0.12.2
0.12.1
0.12.0
0.11.0
0.10.2
0.10.1
0.10.0
0.9.0
0.8.1
0.8.0
0.7.0
0.6.0
0.5.0
0.3.1
0.3.0
0.2.0
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0
Labels
Clear labels   
bug

   
bug

   
documentation

   
enhancement

   
pull-request

Mirrored from GitHub Pull Request

No labels
bug
bug
documentation
enhancement
pull-request
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/App-Store-Connect-CLI#88
No description provided.