> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Publishing & Monetization

> Manage Google Play tracks, releases, store listings, subscriptions, and one-time products

Publishing endpoints expose the owned-app surfaces customers normally manage in Play Console. Read endpoints are useful for dashboards and release audits. Write endpoints should be used carefully and can be validated before committing.

<Warning>
  Release and listing updates write to Google Play. Grant write permissions only to customers who explicitly want automation for publishing workflows.
</Warning>

***

## Release Tracks

### List Tracks

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/google-play/apps/com.example.app/tracks" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

### Get a Track

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/google-play/apps/com.example.app/tracks/production" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

### List Releases on a Track

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/google-play/apps/com.example.app/tracks/production/releases" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

***

## Patch a Track

Use `validateOnly=true` to ask Google to validate the edit without committing it.

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X PATCH "https://api.appeeky.com/v1/connect/google-play/apps/com.example.app/tracks/production?validateOnly=true" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "releases": [
      {
        "name": "3.1.0",
        "versionCodes": ["123"],
        "status": "completed"
      }
    ]
  }'
```

Track patches accept Google's Android Publisher track schema.

***

## Store Listings

### List Listing Localizations

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/google-play/apps/com.example.app/listings" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

### Get One Localization

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/google-play/apps/com.example.app/listings/en-US" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

### Patch Listing Metadata

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X PATCH "https://api.appeeky.com/v1/connect/google-play/apps/com.example.app/listings/en-US?validateOnly=true" \
  -H "X-API-Key: YOUR_APPEEKY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Example App",
    "shortDescription": "Create better screenshots faster.",
    "fullDescription": "Example App helps you create and localize app screenshots for Google Play.",
    "video": "https://www.youtube.com/watch?v=example"
  }'
```

Supported listing fields:

| Field              | Description            |
| ------------------ | ---------------------- |
| `title`            | App title              |
| `shortDescription` | Short description      |
| `fullDescription`  | Full store description |
| `video`            | Promo video URL        |

***

## Monetization Products

### Subscriptions

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/google-play/apps/com.example.app/subscriptions" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

### One-Time Products

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/google-play/apps/com.example.app/one-time-products" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

These endpoints are read-only in the current API surface.

***

## Permission Guidance

| Action                      | Permission guidance              |
| --------------------------- | -------------------------------- |
| Read releases/tracks        | Release read access              |
| Patch releases/tracks       | Release management access        |
| Read listings               | Store listing read access        |
| Patch listings              | Store listing management access  |
| Read subscriptions/products | Monetization product read access |

For production automations, prefer a narrow service account permission set and use `validateOnly=true` in development flows.