Method: purchases.products.consume

  • The endpoint https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:consume is used to consume an in-app purchase for a specific product and token.

  • The request method is POST and the request body must be empty.

  • Path parameters include packageName, productId, and token to identify the application, in-app product, and purchase token.

  • A successful response body is empty.

  • The request requires the https://www.googleapis.com/auth/androidpublisher OAuth scope for authorization.

Consumes a purchase for an inapp item.

HTTP request

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:consume

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
packageName

string

The package name of the application the inapp product was sold in (for example, 'com.some.thing').
productId

string

The inapp product SKU (for example, 'com.some.thing.inapp1').
token

string

The token provided to the user's device when the inapp product was purchased.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Sample

The following is a sample request:

curl \
  -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/products/exampleSKU/tokens/exampleToken:consume' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]'

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/androidpublisher