Method: monetization.onetimeproducts.batchUpdate
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt oder aktualisiert ein oder mehrere Einmalkaufprodukte.
HTTP-Anfrage
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchUpdate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
packageName |
string
Erforderlich. Die übergeordnete App (Paketname), für die die Einmalkäufe aktualisiert werden sollen. Muss mit dem Feld „packageName“ in allen „OneTimeProduct“-Ressourcen übereinstimmen.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
Felder |
requests[] |
object (UpdateOneTimeProductRequest )
Erforderlich. Eine Liste mit bis zu 100 Aktualisierungsanfragen. Alle Anfragen müssen sich auf unterschiedliche Einmalkäufe beziehen.
|
Antworttext
Antwortnachricht für BatchUpdateOneTimeProduct.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"oneTimeProducts": [
{
object (OneTimeProduct )
}
]
} |
Felder |
oneTimeProducts[] |
object (OneTimeProduct )
Die Liste der aktualisierten Einmalprodukte in derselben Reihenfolge wie in der Anfrage.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidpublisher
UpdateOneTimeProductRequest
Anfragenachricht für onetimeproducts.patch.
Felder |
oneTimeProduct |
object (OneTimeProduct )
Erforderlich. Das Einmalkaufprodukt, das eingefügt oder aktualisiert werden soll.
|
updateMask |
string (FieldMask format)
Erforderlich. Die Liste der zu aktualisierenden Felder. Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo" .
|
regionsVersion |
object (RegionsVersion )
Erforderlich. Die Version der verfügbaren Regionen, die für das Einmalkaufprodukt verwendet wird.
|
allowMissing |
boolean
Optional. Wenn der Wert auf „true“ gesetzt ist und das Einmalkaufprodukt mit dem angegebenen packageName und productId nicht vorhanden ist, wird das Einmalkaufprodukt erstellt. Wenn ein neues Einmalkaufprodukt erstellt wird, wird „updateMask“ ignoriert.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
Optional. Die Latenztoleranz für die Weitergabe dieses Produkt-Upsert. Die Standardeinstellung ist „latency-sensitive“.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (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. |"]]