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 مورد نیاز. گزینه خرید والدین (ID) که پیشنهادها باید برای آن به روز شوند. ممکن است برای بهروزرسانی پیشنهادات از گزینههای خرید متعدد، بهعنوان «-» مشخص شود. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
requests[] | object ( GetOneTimeProductOfferRequest ) مورد نیاز. لیستی از درخواست های دریافت تا 100 عنصر. همه درخواست ها باید پیشنهادات مختلف را بازیابی کنند. |
بدن پاسخگو
پیام پاسخ برای پیشنهادات.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 مورد نیاز. محصول یک بار مصرف (ID) والد پیشنهاد برای دریافت. |
purchaseOptionId | string مورد نیاز. گزینه خرید والدین (ID) پیشنهاد را دریافت کنید. |
offerId | string مورد نیاز. شناسه پیشنهاد منحصر به فرد پیشنهاد برای دریافت. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز 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.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. |"]]