Method: monetization.onetimeproducts.batchGet
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قراءة منتج واحد أو أكثر يتم تحصيل سعره مرة واحدة
طلب HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchGet
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات المسار
المعلمات |
packageName |
string
مطلوب. التطبيق الرئيسي (اسم الحزمة) الذي يجب استرداد المنتجات منه. يجب أن تكون القيمة مساوية لقيمة الحقل packageName في جميع الطلبات.
|
مَعلمات طلب البحث
المعلمات |
productIds[] |
string
مطلوب. قائمة تضمّ ما يصل إلى 100 معرّف منتج لاستردادها. يجب أن تكون جميع أرقام التعريف مختلفة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الردّ لنقطة النهاية onetimeproducts.batchGet
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
الحقول |
oneTimeProducts[] |
object (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.batchGet\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 - [JSON representation](#body.BatchGetOneTimeProductsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReads one or more one-time products.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts: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) for which the products should be retrieved. Must be equal to the packageName field on all requests. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------------------------|\n| `productIds[]` | `string` Required. A list of up to 100 product IDs to retrieve. All IDs must be different. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the onetimeproducts.batchGet endpoint.\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 requested one-time products, 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`"]]