Method: monetization.onetimeproducts.purchaseOptions.offers.batchGet
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
קריאה של מבצעים על מוצרים בחיוב חד-פעמי.
בקשת HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchGet
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
packageName |
string
חובה. אפליקציית האב (שם החבילה) של המבצעים המעודכנים. הערך חייב להיות זהה לערך בשדה packageName בכל המשאבים המעודכנים מסוג OneTimeProductOffer.
|
productId |
string
חובה. מזהה המוצר של מוצר ההורה לחיוב חד-פעמי, אם כל המבצעים המעודכנים שייכים לאותו מוצר. אם הבקשה הזו מתייחסת לכמה מוצרים חד-פעמיים, צריך להגדיר את השדה הזה כ-'-'.
|
purchaseOptionId |
string
חובה. אפשרות הרכישה הראשית (המזהה) שעבורה צריך לעדכן את המבצעים. אפשר לציין '-' כדי לעדכן מבצעים מכמה אפשרויות רכישה.
|
גוף הבקשה
גוף הבקשה מכיל נתונים עם המבנה הבא:
| שדות |
requests[] |
object (GetOneTimeProductOfferRequest)
חובה. רשימה של בקשות GET עם עד 100 רכיבים. כל הבקשות צריכות לאחזר מבצעים שונים.
|
גוף התשובה
הודעת התגובה לנקודת הקצה offers.batchGet.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| שדות |
oneTimeProductOffers[] |
object (OneTimeProductOffer)
רשימת המוצרים בחיוב חד-פעמי שעודכנו, באותו סדר שבו הם מופיעים בבקשה.
|
היקפי הרשאה
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/androidpublisher
GetOneTimeProductOfferRequest
הודעת בקשה ל-GetOneTimeProductOffers.
| ייצוג ב-JSON |
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string
} |
| שדות |
packageName |
string
חובה. אפליקציית האב (שם החבילה) של המבצע שרוצים לקבל.
|
productId |
string
חובה. מזהה המוצר בחיוב חד-פעמי של מוצר האב של המבצע שרוצים לקבל.
|
purchaseOptionId |
string
חובה. אפשרות הרכישה הראשית (המזהה) של המבצע שרוצים לקבל.
|
offerId |
string
חובה. המזהה הייחודי של המבצע שרוצים לקבל.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון 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.purchaseOptions.offers.batchGet\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.BatchGetOneTimeProductOffersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [GetOneTimeProductOfferRequest](#GetOneTimeProductOfferRequest)\n - [JSON representation](#GetOneTimeProductOfferRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nReads one or more one-time product offers.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchGet`\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) of the updated offers. Must be equal to the packageName field on all the updated OneTimeProductOffer resources. |\n| `productId` | `string` Required. The product ID of the parent one-time product, if all updated offers belong to the same product. If this request spans multiple one-time products, set this field to \"-\". |\n| `purchaseOptionId` | `string` Required. The parent purchase option (ID) for which the offers should be updated. May be specified as '-' to update offers from multiple purchase options. |\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.purchaseOptions.offers/batchGet#GetOneTimeProductOfferRequest) } ] } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[GetOneTimeProductOfferRequest](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers/batchGet#GetOneTimeProductOfferRequest)`)` Required. A list of get requests of up to 100 elements. All requests must retrieve different offers. |\n\n### Response body\n\nResponse message for the offers.batchGet endpoint.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"oneTimeProductOffers\": [ { object (/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer) } ] } ``` |\n\n| Fields ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `oneTimeProductOffers[]` | `object (`[OneTimeProductOffer](/android-publisher/api-ref/rest/v3/monetization.onetimeproducts.purchaseOptions.offers#OneTimeProductOffer)`)` The list of updated one-time product offers, 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\nGetOneTimeProductOfferRequest\n-----------------------------\n\nRequest message for GetOneTimeProductOffers.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------|\n| ``` { \"packageName\": string, \"productId\": string, \"purchaseOptionId\": string, \"offerId\": string } ``` |\n\n| Fields ||\n|--------------------|--------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) of the offer to get. |\n| `productId` | `string` Required. The parent one-time product (ID) of the offer to get. |\n| `purchaseOptionId` | `string` Required. The parent purchase option (ID) of the offer to get. |\n| `offerId` | `string` Required. The unique offer ID of the offer to get. |"]]
