Method: monetization.onetimeproducts.batchUpdate

  • The batchUpdate method allows creation or updates of one or more one-time products using an HTTP POST request.

  • The request requires the package name as a path parameter and a request body containing a list of update requests.

  • Each update request includes the one-time product object, an update mask specifying fields to change, and the regions version.

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

  • Authorization requires the https://www.googleapis.com/auth/androidpublisher OAuth scope.

Creates or updates one or more one-time products.

HTTP request

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchUpdate

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
packageName

string

Required. The parent app (package name) for which the one-time products should be updated. Must be equal to the packageName field on all the OneTimeProduct resources.

Request body

The request body contains data with the following structure:

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

object (UpdateOneTimeProductRequest)

Required. A list of update requests of up to 100 elements. All requests must update different one-time products.

Response body

Response message for BatchUpdateOneTimeProduct.

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

JSON representation 
{
  "oneTimeProducts": [
    {
      object (OneTimeProduct)
    }
  ]
}
Fields
oneTimeProducts[]

object (OneTimeProduct)

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

Authorization scopes

Requires the following OAuth scope:

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

UpdateOneTimeProductRequest

Request message for onetimeproducts.patch.

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

object (OneTimeProduct)

Required. The one-time product to upsert.
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 one-time product.
allowMissing

boolean

Optional. If set to true, and the one-time product with the given packageName and productId doesn't exist, the one-time product will be created.

If a new one-time product is created, updateMask is ignored.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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