Method: monetization.onetimeproducts.patch
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تنشئ هذه الطريقة منتجًا يتم تحصيل سعره مرة واحدة أو تعدّله.
طلب HTTP
PATCH https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{oneTimeProduct.packageName}/onetimeproducts/{oneTimeProduct.productId}
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
| المعلمات |
oneTimeProduct.packageName |
string
مطلوب. غير قابل للتغيير اسم حزمة التطبيق الرئيسي
|
oneTimeProduct.productId |
string
مطلوب. غير قابل للتغيير المعرّف الفريد للمنتج يجب أن يكون المعرّف فريدًا داخل التطبيق الرئيسي، وأن يبدأ برقم أو حرف صغير، ويمكن أن يشتمل على أرقام (0-9) وحروف صغيرة (a-z) وشُرط سفلية (_) ونقاط (.).
|
مَعلمات طلب البحث
| المعلمات |
updateMask |
string (FieldMask format)
مطلوب. قائمة الحقول التي سيتم تعديلها هذه قائمة مفصولة بفواصل تتضمّن الأسماء المؤهَّلة بالكامل للحقول. مثال: "user.displayName,photo"
|
regionsVersion |
object (RegionsVersion)
مطلوب. إصدار المناطق المتاحة المستخدَم للمنتج الذي يتم شراؤه لمرة واحدة
|
allowMissing |
boolean
اختيارية: إذا تم ضبط القيمة على "صحيح" ولم يكن المنتج الذي يتم شراؤه لمرة واحدة والمزوّد بالاسم packageName والمعرّف productId المحدّدين متوفّرًا، سيتم إنشاء المنتج الذي يتم شراؤه لمرة واحدة. في حال إنشاء منتج جديد يتم تحصيل سعره مرة واحدة، سيتم تجاهل updateMask.
|
latencyTolerance |
enum (ProductUpdateLatencyTolerance)
اختيارية: الحدّ الأقصى المسموح به لوقت الاستجابة لعملية إدراج/تعديل المنتج هذه. يتم ضبط القيمة التلقائية على "حساسة لوقت الاستجابة".
|
نص الطلب
يحتوي نص الطلب على مثال OneTimeProduct.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال OneTimeProduct.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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`"]]
