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