Method: monetization.onetimeproducts.purchaseOptions.offers.activate

  • This document details how to activate a one-time product offer using a POST request to a specific URL.

  • Activating an offer requires specifying the packageName, productId, purchaseOptionId, and offerId as path parameters.

  • The request body optionally includes a latencyTolerance field to control update propagation speed.

  • A successful response returns an instance of OneTimeProductOffer.

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

Activates a one-time product offer.

HTTP request

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers/{offerId}:activate

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
packageName

string

Required. The parent app (package name) of the offer to activate.
productId

string

Required. The parent one-time product (ID) of the offer to activate.
purchaseOptionId

string

Required. The parent purchase option (ID) of the offer to activate.
offerId

string

Required. The offer ID of the offer to activate.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Fields
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.

Response body

If successful, the response body contains an instance of OneTimeProductOffer.

Authorization scopes

Requires the following OAuth scope:

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