Method: monetization.onetimeproducts.batchUpdate
Stay organized with collections
Save and categorize content based on your preferences.
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:
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.
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-16 UTC.
[null,null,["Last updated 2025-07-16 UTC."],[],[],null,["# Method: monetization.onetimeproducts.batchUpdate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BatchUpdateOneTimeProductsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [UpdateOneTimeProductRequest](#UpdateOneTimeProductRequest)\n - [JSON representation](#UpdateOneTimeProductRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nCreates or updates one or more one-time products.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchUpdate`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requests\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts/batchUpdate#UpdateOneTimeProductRequest) } ] } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[UpdateOneTimeProductRequest](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts/batchUpdate#UpdateOneTimeProductRequest)`)` Required. A list of update requests of up to 100 elements. All requests must update different one-time products. |\n\n### Response body\n\nResponse message for BatchUpdateOneTimeProduct.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"oneTimeProducts\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct) } ] } ``` |\n\n| Fields ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `oneTimeProducts[]` | `object (`[OneTimeProduct](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct)`)` The list of updated one-time products list, in the same order as the request. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nUpdateOneTimeProductRequest\n---------------------------\n\nRequest message for onetimeproducts.patch.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"oneTimeProduct\": { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct) }, \"updateMask\": string, \"regionsVersion\": { object (/android-publisher/api-ref/rest/v3/RegionsVersion) }, \"allowMissing\": boolean, \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance) } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `oneTimeProduct` | `object (`[OneTimeProduct](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct)`)` Required. The one-time product to upsert. |\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` 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\"`. |\n| `regionsVersion` | `object (`[RegionsVersion](/android-publisher/api-ref/rest/v3/RegionsVersion)`)` Required. The version of the available regions being used for the one-time product. |\n| `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. |\n| `latencyTolerance` | `enum (`[ProductUpdateLatencyTolerance](/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance)`)` Optional. The latency tolerance for the propagation of this product upsert. Defaults to latency-sensitive. |"]]