Method: monetization.onetimeproducts.batchUpdate
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک یا چند محصول یکبار مصرف ایجاد یا به روز می کند.
درخواست HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchUpdate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
packageName | string مورد نیاز. برنامه والد (نام بسته) که محصولات یکبار مصرف برای آن باید به روز شوند. باید برابر با قسمت packageName در همه منابع OneTimeProduct باشد. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
requests[] | object ( UpdateOneTimeProductRequest ) مورد نیاز. لیستی از درخواست های به روز رسانی تا 100 عنصر. همه درخواست ها باید محصولات مختلف یک بار مصرف را به روز کنند. |
بدن پاسخگو
پیام پاسخ برای BatchUpdateOneTimeProduct.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
oneTimeProducts[] | object ( OneTimeProduct ) لیست به روز شده لیست محصولات یک بار مصرف، به همان ترتیب درخواست. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidpublisher
UpdateOneTimeProductRequest
درخواست پیام برای onetimeproducts.patch.
فیلدها |
---|
oneTimeProduct | object ( OneTimeProduct ) مورد نیاز. محصول یکبار مصرف برای معرفی |
updateMask | string ( FieldMask format) مورد نیاز. لیست فیلدهایی که باید به روز شوند. این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" . |
regionsVersion | object ( RegionsVersion ) مورد نیاز. نسخه مناطق موجود که برای محصول یکبار مصرف استفاده می شود. |
allowMissing | boolean اختیاری. اگر روی true تنظیم شود، و محصول یکبار مصرف با packageName و productId داده شده وجود نداشته باشد، محصول یکبار مصرف ایجاد خواهد شد. اگر یک محصول یک بار مصرف جدید ایجاد شود، updateMask نادیده گرفته می شود. |
latencyTolerance | enum ( ProductUpdateLatencyTolerance ) اختیاری. تحمل تاخیر برای انتشار این محصول بالاست. به طور پیش فرض حساس به تأخیر است. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: monetization.onetimeproducts.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.BatchUpdateOneTimeProductsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [UpdateOneTimeProductRequest](#UpdateOneTimeProductRequest)\n - [JSON representation](#UpdateOneTimeProductRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nCreates or updates one or more one-time products.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts: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) for which the one-time products should be updated. Must be equal to the packageName field on all the OneTimeProduct resources. |\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/batchUpdate#UpdateOneTimeProductRequest) } ] } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[UpdateOneTimeProductRequest](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts/batchUpdate#UpdateOneTimeProductRequest)`)` Required. A list of update requests of up to 100 elements. All requests must update different one-time products. |\n\n### Response body\n\nResponse message for BatchUpdateOneTimeProduct.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"oneTimeProducts\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct) } ] } ``` |\n\n| Fields ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `oneTimeProducts[]` | `object (`[OneTimeProduct](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct)`)` The list of updated one-time products list, 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\nUpdateOneTimeProductRequest\n---------------------------\n\nRequest message for onetimeproducts.patch.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"oneTimeProduct\": { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct) }, \"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| `oneTimeProduct` | `object (`[OneTimeProduct](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct)`)` Required. The one-time product to upsert. |\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. |"]]