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), אותיות קטנות (a-z), קווים תחתונים (_) ונקודות (.).
|
פרמטרים של שאילתה
| פרמטרים |
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 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[],[],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`"]]
