Endpoints

Call these through the okoro proxy at https://okoro.ai/p/google-play

Action	Method	Min scope
Read product purchase	`GET`	`read`
Acknowledge product purchase	`POST`	`write`
Read subscription purchase	`GET`	`read`
Acknowledge subscription	`POST`	`write`
Cancel subscription	`POST`	`write`
List reviews	`GET`	`read`
Read review	`GET`	`read`
Reply to review	`POST`	`write`
List in-app products	`GET`	`read`
Create in-app product	`POST`	`write`
Update in-app product	`PUT`	`update`
Delete in-app product	`DELETE`	`delete`

Examples

Every request requires a short-lived operation token scoped to a single action.

1. Get an operation token

Exchange your service token for a short-lived operation token scoped to a single action.

TOKEN=$(curl -sX POST "https://okoro.ai/t/tokens" \
  -H "Authorization: Bearer $OKORO_SERVICE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider": "google-play", "scope": "read", "intent": "describe what you are doing"}' \
  | jq -r '.token')

2. Call the API

Use the operation token as a Bearer token. The proxy forwards the request to Google Play and logs the action.

Read product purchase

curl -X GET "https://okoro.ai/p/google-play/applications/{id}/purchases/products/{id}" \
  -H "Authorization: Bearer $TOKEN"

Acknowledge product purchase

curl -X POST "https://okoro.ai/p/google-play/applications/{id}/purchases/products/{id}/acknowledge" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Read subscription purchase

curl -X GET "https://okoro.ai/p/google-play/applications/{id}/purchases/subscriptions/{id}" \
  -H "Authorization: Bearer $TOKEN"

Acknowledge subscription

curl -X POST "https://okoro.ai/p/google-play/applications/{id}/purchases/subscriptions/{id}/acknowledge" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Cancel subscription

curl -X POST "https://okoro.ai/p/google-play/applications/{id}/purchases/subscriptions/{id}/cancel" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

List reviews

curl -X GET "https://okoro.ai/p/google-play/applications/{id}/reviews" \
  -H "Authorization: Bearer $TOKEN"

Read review

curl -X GET "https://okoro.ai/p/google-play/applications/{id}/reviews/{id}" \
  -H "Authorization: Bearer $TOKEN"

Reply to review

curl -X POST "https://okoro.ai/p/google-play/applications/{id}/reviews/{id}:reply" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

List in-app products

curl -X GET "https://okoro.ai/p/google-play/applications/{id}/inappproducts" \
  -H "Authorization: Bearer $TOKEN"

Create in-app product

curl -X POST "https://okoro.ai/p/google-play/applications/{id}/inappproducts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Update in-app product

curl -X PUT "https://okoro.ai/p/google-play/applications/{id}/inappproducts/{id}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete in-app product

curl -X DELETE "https://okoro.ai/p/google-play/applications/{id}/inappproducts/{id}" \
  -H "Authorization: Bearer $TOKEN"

Scopes

Your service token must be configured with at least the required scope level.

read

GET

/applications/* /applications/*/purchases/** /applications/*/reviews /applications/*/reviews/* /applications/*/inappproducts /applications/*/inappproducts/*

write

GET POST

/applications/* /applications/*/purchases/** /applications/*/reviews /applications/*/reviews/* /applications/*/reviews/*:reply /applications/*/inappproducts /applications/*/inappproducts/*

update

GET POST PUT PATCH

delete

GET POST PUT PATCH DELETE

/applications/* /applications/*/purchases/** /applications/*/reviews/*:reply /applications/*/inappproducts /applications/*/inappproducts/*

all

GET POST PUT PATCH DELETE

/**