Method: monetization.onetimeproducts.patch
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt oder aktualisiert ein Einmalkaufprodukt.
HTTP-Anfrage
PATCH https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{oneTimeProduct.packageName}/onetimeproducts/{oneTimeProduct.productId}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
oneTimeProduct.packageName |
string
Erforderlich. Nicht veränderbar. Paketname der übergeordneten App.
|
oneTimeProduct.productId |
string
Erforderlich. Nicht veränderbar. Eindeutige Produkt-ID des Produkts. Eindeutig innerhalb der übergeordneten App. Produkt-IDs müssen mit einer Ziffer oder einem Kleinbuchstaben beginnen und können Ziffern (0–9), Kleinbuchstaben (a–z), Unterstriche (_) und Punkte (.) enthalten.
|
Abfrageparameter
| Parameter |
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“.
|
Anfragetext
Der Anfragetext enthält eine Instanz von OneTimeProduct.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von OneTimeProduct.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidpublisher
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.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates or updates a one-time product.\n\n### HTTP request\n\n`PATCH https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{oneTimeProduct.packageName}/onetimeproducts/{oneTimeProduct.productId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `oneTimeProduct.packageName` | `string` Required. Immutable. Package name of the parent app. |\n| `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 (.). |\n\n### Query parameters\n\n| Parameters ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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. |\n\n### Request body\n\nThe request body contains an instance of [OneTimeProduct](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct).\n\n### Response body\n\nIf successful, the response body contains an instance of [OneTimeProduct](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
