Method: monetization.onetimeproducts.patch
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک محصول یکبار مصرف ایجاد یا به روز می کند.
درخواست HTTP
PATCH https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{oneTimeProduct.packageName}/onetimeproducts/{oneTimeProduct.productId}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
oneTimeProduct.packageName | string مورد نیاز. تغییرناپذیر. نام بسته برنامه والد. |
oneTimeProduct.productId | string مورد نیاز. تغییرناپذیر. شناسه محصول منحصر به فرد محصول. منحصر به فرد در برنامه والد. شناسه محصول باید با یک عدد یا حرف کوچک شروع شود و می تواند شامل اعداد (0-9)، حروف کوچک (az)، زیرخط (_) و نقطه (.) باشد. |
پارامترهای پرس و جو
| پارامترها |
|---|
updateMask | string ( FieldMask format) مورد نیاز. لیست فیلدهایی که باید به روز شوند. این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" . |
regionsVersion | object ( RegionsVersion ) مورد نیاز. نسخه مناطق موجود که برای محصول یکبار مصرف استفاده می شود. |
allowMissing | boolean اختیاری. اگر روی true تنظیم شود، و محصول یکبار مصرف با packageName و productId داده شده وجود نداشته باشد، محصول یکبار مصرف ایجاد خواهد شد. اگر یک محصول یک بار مصرف جدید ایجاد شود، updateMask نادیده گرفته می شود. |
latencyTolerance | enum ( ProductUpdateLatencyTolerance ) اختیاری. تحمل تاخیر برای انتشار این محصول بالاست. به طور پیش فرض حساس به تأخیر است. |
درخواست بدن
بدنه درخواست شامل یک نمونه از OneTimeProduct است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه از OneTimeProduct است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidpublisher
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز 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.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates or updates a one-time product.\n\n### HTTP request\n\n`PATCH https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{oneTimeProduct.packageName}/onetimeproducts/{oneTimeProduct.productId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `oneTimeProduct.packageName` | `string` Required. Immutable. Package name of the parent app. |\n| `oneTimeProduct.productId` | `string` Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.). |\n\n### Query parameters\n\n| Parameters ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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. |\n\n### Request body\n\nThe request body contains an instance of [OneTimeProduct](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct).\n\n### Response body\n\nIf successful, the response body contains an instance of [OneTimeProduct](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts#OneTimeProduct).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
