Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea o aggiorna una o più offerte di prodotti a pagamento singolo.
Richiesta HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdate
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
packageName |
string
Obbligatorio. L'app principale (nome del pacchetto) delle offerte aggiornate. Deve essere uguale al campo packageName in tutte le risorse OneTimeProductOffer aggiornate.
|
productId |
string
Obbligatorio. L'ID prodotto del prodotto a pagamento singolo principale, se tutte le offerte aggiornate appartengono allo stesso prodotto. Se questa richiesta riguarda più prodotti una tantum, imposta questo campo su "-".
|
purchaseOptionId |
string
Obbligatorio. L'opzione di acquisto principale (ID) per cui devono essere aggiornate le offerte. Può essere specificato come "-" per aggiornare le offerte di più opzioni di acquisto.
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Campi |
requests[] |
object (UpdateOneTimeProductOfferRequest )
Obbligatorio. Un elenco di richieste di aggiornamento di un massimo di 100 elementi. Tutte le richieste devono aggiornare offerte diverse.
|
Corpo della risposta
Messaggio di risposta per offers.batchUpdate.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Campi |
oneTimeProductOffers[] |
object (OneTimeProductOffer )
L'elenco delle offerte di prodotti a pagamento singolo aggiornate, nello stesso ordine della richiesta.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidpublisher
UpdateOneTimeProductOfferRequest
Messaggio di richiesta per UpdateOneTimeProductOffer.
Campi |
oneTimeProductOffer |
object (OneTimeProductOffer )
Obbligatorio. L'offerta di prodotto a pagamento singolo da aggiornare.
|
updateMask |
string (FieldMask format)
Obbligatorio. L'elenco dei campi da aggiornare. Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo" .
|
regionsVersion |
object (RegionsVersion )
Obbligatorio. La versione delle regioni disponibili utilizzate per l'offerta.
|
allowMissing |
boolean
(Facoltativo) Se è impostato su true e l'offerta con packageName, productId, purchaseOptionId e offerId specificati non esiste, verrà creata un'offerta. Se viene creata una nuova offerta, updateMask viene ignorato.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
(Facoltativo) La tolleranza alla latenza per la propagazione di questo aggiornamento dell'offerta. Il valore predefinito è sensibile alla latenza.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]