Method: monetization.onetimeproducts.patch

  • This page details how to create or update a one-time product using a PATCH request to the specified API endpoint.

  • The request requires path parameters for the package name and product ID, and query parameters including an update mask and regions version.

  • The request body contains an instance of OneTimeProduct, and a successful response will also return an instance of OneTimeProduct.

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

Creates or updates a one-time product.

HTTP request

PATCH https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{oneTimeProduct.packageName}/onetimeproducts/{oneTimeProduct.productId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
oneTimeProduct.packageName

string

Required. Immutable. Package name of the parent app.
oneTimeProduct.productId

string

Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).

Query parameters

Parameters
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.

Request body

The request body contains an instance of OneTimeProduct.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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