Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt oder aktualisiert ein oder mehrere Einmalkaufproduktangebote.
HTTP-Anfrage
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
packageName |
string
Erforderlich. Die übergeordnete App (Paketname) der aktualisierten Angebote. Muss dem Feld „packageName“ in allen aktualisierten „OneTimeProductOffer“-Ressourcen entsprechen.
|
productId |
string
Erforderlich. Die Produkt-ID des übergeordneten Einmalkaufprodukts, wenn alle aktualisierten Angebote zum selben Produkt gehören. Wenn sich diese Anfrage auf mehrere Einmalkäufe bezieht, setzen Sie dieses Feld auf „-“.
|
purchaseOptionId |
string
Erforderlich. Die übergeordnete Kaufoption (ID), für die die Angebote aktualisiert werden sollen. Kann als „-“ angegeben werden, um Angebote aus mehreren Kaufoptionen zu aktualisieren.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
Felder |
requests[] |
object (UpdateOneTimeProductOfferRequest )
Erforderlich. Eine Liste mit bis zu 100 Aktualisierungsanfragen. Alle Anfragen müssen sich auf unterschiedliche Angebote beziehen.
|
Antworttext
Antwortnachricht für „offers.batchUpdate“.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Felder |
oneTimeProductOffers[] |
object (OneTimeProductOffer )
Die Liste der aktualisierten Einmalkaufangebote in derselben Reihenfolge wie in der Anfrage.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidpublisher
UpdateOneTimeProductOfferRequest
Anfragenachricht für UpdateOneTimeProductOffer
Felder |
oneTimeProductOffer |
object (OneTimeProductOffer )
Erforderlich. Das zu aktualisierende Einmalkaufproduktangebot.
|
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 Angebot verwendet wird.
|
allowMissing |
boolean
Optional. Wenn „true“ festgelegt ist und das Angebot mit dem angegebenen „packageName“, „productId“, „purchaseOptionId“ und „offerId“ nicht vorhanden ist, wird ein Angebot erstellt. Wenn ein neues Angebot erstellt wird, wird die updateMask ignoriert.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
Optional. Die Latenztoleranz für die Weitergabe dieser Angebotsaktualisierung. 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.purchaseOptions.offers.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.BatchUpdateOneTimeProductOffersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [UpdateOneTimeProductOfferRequest](#UpdateOneTimeProductOfferRequest)\n - [JSON representation](#UpdateOneTimeProductOfferRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nCreates or updates one or more one-time product offers.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers: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) of the updated offers. Must be equal to the packageName field on all the updated OneTimeProductOffer resources. |\n| `productId` | `string` Required. The product ID of the parent one-time product, if all updated offers belong to the same product. If this request spans multiple one-time products, set this field to \"-\". |\n| `purchaseOptionId` | `string` Required. The parent purchase option (ID) for which the offers should be updated. May be specified as '-' to update offers from multiple purchase options. |\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.purchaseOptions.offers/batchUpdate#UpdateOneTimeProductOfferRequest) } ] } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[UpdateOneTimeProductOfferRequest](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers/batchUpdate#UpdateOneTimeProductOfferRequest)`)` Required. A list of update requests of up to 100 elements. All requests must update different offers. |\n\n### Response body\n\nResponse message for offers.batchUpdate.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"oneTimeProductOffers\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer) } ] } ``` |\n\n| Fields ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `oneTimeProductOffers[]` | `object (`[OneTimeProductOffer](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer)`)` The list of updated one-time product offers, 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\nUpdateOneTimeProductOfferRequest\n--------------------------------\n\nRequest message for UpdateOneTimeProductOffer.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"oneTimeProductOffer\": { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer) }, \"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| `oneTimeProductOffer` | `object (`[OneTimeProductOffer](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer)`)` Required. The one-time product offer to update. |\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 offer. |\n| `allowMissing` | `boolean` Optional. If set to true, and the offer with the given packageName, productId, purchaseOptionId and offerId doesn't exist, an offer will be created. If a new offer is created, the updateMask is ignored. |\n| `latencyTolerance` | `enum (`[ProductUpdateLatencyTolerance](/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance)`)` Optional. The latency tolerance for the propagation of this offer update. Defaults to latency-sensitive. |"]]