Get the FREE Ultimate OpenClaw Setup Guide →

gpd-id-resolver

Scanned
npx machina-cli add skill rudrankriyam/app-store-connect-cli-skills/gpd-id-resolver --openclaw
Files (1)
SKILL.md
1.8 KB

GPD ID Resolver

Use this skill to map names to IDs needed by other gpd commands.

Package name (app ID)

  • Package name is the primary identifier: com.example.app.
  • Always pass --package explicitly for deterministic results.

Track names

  • Common tracks: internal, alpha, beta, production.
  • List tracks:
    • gpd publish tracks --package com.example.app

Version codes and release status

  • Use release status to find version codes on a track:
    • gpd publish status --package com.example.app --track production

Tester groups

  • List testers by track:
    • gpd publish testers list --package com.example.app --track internal

Monetization IDs

  • Products:
    • gpd monetization products list --package com.example.app
    • gpd monetization products get sku123 --package com.example.app
  • One-time products:
    • gpd monetization onetimeproducts list --package com.example.app
  • Subscriptions:
    • gpd monetization subscriptions list --package com.example.app
    • gpd monetization subscriptions get sub123 --package com.example.app
  • Base plans and offers:
    • gpd monetization baseplans migrate-prices --package com.example.app sub123 plan456 --region-code US --price-micros 9990000
    • gpd monetization offers list --package com.example.app sub123 plan456

Permissions IDs

  • Developer users:
    • gpd permissions users list --developer-id DEV_ID
  • App grants:
    • gpd permissions grants create --package com.example.app --email user@example.com --app-permissions CAN_REPLY_TO_REVIEWS

Output tips

  • JSON is default; use --pretty for debugging.
  • Use --all on list commands to avoid missing items.

Source

git clone https://github.com/rudrankriyam/app-store-connect-cli-skills/blob/main/skills/gpd-id-resolver/SKILL.mdView on GitHub

Overview

GPD ID Resolver maps human-friendly names to IDs used by other gpd commands. It covers package names, track IDs, version codes, tester groups, and monetization IDs (products, subscriptions, base plans, and offers). Use when commands require IDs or exact values.

How This Skill Works

Supply a known name or slug and let the resolver guide you to the corresponding ID by querying the relevant gpd commands (e.g., tracks, status, testers, monetization, permissions). Always pass the app package with --package to guarantee deterministic results, and use --all on list commands to avoid missing items.

When to Use It

  • When you know the app and need the exact package name for deterministic results.
  • When you need track IDs or version codes for a given track.
  • When you need tester group IDs for a specific track.
  • When you need monetization IDs (products, subscriptions, base plans, offers).
  • When you need permission or app-grant IDs (permissions users, app grants).

Quick Start

  1. Step 1: Identify the app package name (e.g., com.example.app) and pass --package.
  2. Step 2: Run relevant list/get commands to resolve IDs you need (tracks, status, testers, products, subscriptions, permissions).
  3. Step 3: Use the retrieved IDs in subsequent gpd commands.

Best Practices

  • Always pass --package for deterministic results.
  • Use --all on list commands to avoid missing items.
  • Use get commands (e.g., get sku123, sub123) to fetch exact IDs.
  • Validate region codes and price micros when migrating prices in base plans/offers.
  • Append --pretty for debugging, then switch to default JSON for production.

Example Use Cases

  • gpd publish tracks --package com.example.app
  • gpd publish status --package com.example.app --track production
  • gpd monetization products list --package com.example.app
  • gpd monetization subscriptions get sub123 --package com.example.app
  • gpd permissions users list --developer-id DEV_ID

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers