Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée ou met à jour une ou plusieurs offres de produits ponctuels.
Requête HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdate
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
packageName |
string
Obligatoire. Application parente (nom du package) des offres mises à jour. Doit être égal au champ packageName de toutes les ressources OneTimeProductOffer mises à jour.
|
productId |
string
Obligatoire. ID du produit ponctuel parent, si toutes les offres mises à jour appartiennent au même produit. Si cette demande concerne plusieurs produits ponctuels, définissez ce champ sur "-".
|
purchaseOptionId |
string
Obligatoire. Option d'achat parente (ID) pour laquelle les offres doivent être mises à jour. Peut être spécifié sous la forme "-" pour mettre à jour les offres de plusieurs options d'achat.
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Champs |
requests[] |
object (UpdateOneTimeProductOfferRequest )
Obligatoire. Liste de requêtes de mise à jour (100 éléments maximum). Toutes les demandes doivent concerner des offres différentes.
|
Corps de la réponse
Message de réponse pour offers.batchUpdate.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Champs |
oneTimeProductOffers[] |
object (OneTimeProductOffer )
Liste des offres de produits ponctuels mises à jour, dans le même ordre que la requête.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/androidpublisher
UpdateOneTimeProductOfferRequest
Message de requête pour UpdateOneTimeProductOffer.
Champs |
oneTimeProductOffer |
object (OneTimeProductOffer )
Obligatoire. Offre de produit ponctuel à modifier.
|
updateMask |
string (FieldMask format)
Obligatoire. Liste des champs à mettre à jour. Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"
|
regionsVersion |
object (RegionsVersion )
Obligatoire. Version des régions disponibles utilisées pour l'offre.
|
allowMissing |
boolean
Facultatif. Si la valeur est définie sur "true" et que l'offre avec les packageName, productId, purchaseOptionId et offerId indiqués n'existe pas, une offre sera créée. Si une offre est créée, updateMask est ignoré.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
Facultatif. Tolérance de latence pour la propagation de la mise à jour de cette offre. La valeur par défaut est "sensible à la latence".
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]