Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Membuat atau memperbarui satu atau beberapa penawaran produk sekali beli.
Permintaan HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdate
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
packageName |
string
Wajib. Aplikasi induk (nama paket) dari penawaran yang diperbarui. Harus sama dengan kolom packageName pada semua resource OneTimeProductOffer yang diperbarui.
|
productId |
string
Wajib. ID produk dari produk sekali beli induk, jika semua penawaran yang diperbarui termasuk dalam produk yang sama. Jika permintaan ini mencakup beberapa produk sekali beli, setel kolom ini ke "-".
|
purchaseOptionId |
string
Wajib. Opsi pembelian induk (ID) yang harus diperbarui penawarannya. Dapat ditentukan sebagai '-' untuk memperbarui penawaran dari beberapa opsi pembelian.
|
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Kolom |
requests[] |
object (UpdateOneTimeProductOfferRequest )
Wajib. Daftar permintaan update hingga 100 elemen. Semua permintaan harus memperbarui penawaran yang berbeda.
|
Isi respons
Pesan respons untuk offers.batchUpdate.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Kolom |
oneTimeProductOffers[] |
object (OneTimeProductOffer )
Daftar penawaran produk sekali beli yang diperbarui, dalam urutan yang sama dengan permintaan.
|
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/androidpublisher
UpdateOneTimeProductOfferRequest
Pesan permintaan untuk UpdateOneTimeProductOffer.
Kolom |
oneTimeProductOffer |
object (OneTimeProductOffer )
Wajib. Penawaran produk sekali beli yang akan diperbarui.
|
updateMask |
string (FieldMask format)
Wajib. Daftar kolom yang akan diperbarui. Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo" .
|
regionsVersion |
object (RegionsVersion )
Wajib. Versi wilayah yang tersedia yang digunakan untuk penawaran.
|
allowMissing |
boolean
Opsional. Jika disetel ke benar (true), dan penawaran dengan packageName, productId, purchaseOptionId, dan offerId yang diberikan tidak ada, penawaran akan dibuat. Jika penawaran baru dibuat, updateMask diabaikan.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance )
Opsional. Toleransi latensi untuk propagasi pembaruan penawaran ini. Default-nya sensitif terhadap latensi.
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]