Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate

  • The batchUpdate method allows you to create or update one or more one-time product offers using a POST request to a specified URL.

  • The request requires path parameters for the package name, product ID, and purchase option ID, with options for specifying multiple products or purchase options.

  • The request body contains a list of up to 100 UpdateOneTimeProductOfferRequest objects, each detailing an offer to be updated.

  • The response body returns a list of the updated one-time product offers.

  • This method requires authorization using the https://www.googleapis.com/auth/androidpublisher OAuth scope.

Creates or updates one or more one-time product offers.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
packageName

string

Required. The parent app (package name) of the updated offers.

Must be equal to the packageName field on all the updated OneTimeProductOffer resources.
productId

string

Required. The product ID of the parent one-time product, if all updated offers belong to the same product. If this request spans multiple one-time products, set this field to "-".
purchaseOptionId

string

Required. The parent purchase option (ID) for which the offers should be updated. May be specified as '-' to update offers from multiple purchase options.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "requests": [
    {
      object (UpdateOneTimeProductOfferRequest)
    }
  ]
}
Fields
requests[]

object (UpdateOneTimeProductOfferRequest)

Required. A list of update requests of up to 100 elements. All requests must update different offers.

Response body

Response message for offers.batchUpdate.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
Fields
oneTimeProductOffers[]

object (OneTimeProductOffer)

The list of updated one-time product offers, in the same order as the request.

Authorization scopes

Requires the following OAuth scope:

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

UpdateOneTimeProductOfferRequest

Request message for UpdateOneTimeProductOffer.

JSON representation 
{
  "oneTimeProductOffer": {
    object (OneTimeProductOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Fields
oneTimeProductOffer

object (OneTimeProductOffer)

Required. The one-time product offer to update.
updateMask

string (FieldMask format)

Required. The list of fields to be updated.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
regionsVersion

object (RegionsVersion)

Required. The version of the available regions being used for the offer.
allowMissing

boolean

Optional. If set to true, and the offer with the given packageName, productId, purchaseOptionId and offerId doesn't exist, an offer will be created.

If a new offer is created, the updateMask is ignored.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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