Method: monetization.subscriptions.batchGet
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يقرأ اشتراك واحد أو أكثر.
طلب HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchGet
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
packageName |
string
مطلوب. التطبيق الرئيسي (اسم الحزمة) الذي يجب استرداد الاشتراكات له يجب أن تساوي قيمة الحقل packageName في جميع الطلبات.
|
معامِلات طلب البحث
| المعلمات |
productIds[] |
string
مطلوب. قائمة تضم ما يصل إلى 100 معرّف منتجات متوفّرة عند الاشتراك لاستردادها يجب أن تكون جميع المعرّفات مختلفة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة استجابة لنقطة نهاية Subscriptions.batchGet.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"subscriptions": [
{
object (Subscription)
}
]
} |
| الحقول |
subscriptions[] |
object (Subscription)
قائمة الاشتراكات المطلوبة بالترتيب نفسه الذي طلب به الطلب
|
نطاقات الأذونات
يجب توفير نطاق 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 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves details for one or more app subscriptions using their product IDs.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the app's package name and a list of subscription product IDs.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of subscriptions corresponding to the provided product IDs, if found.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003eGET\u003c/code\u003e HTTP method and requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eRequest body should be empty.\u003c/p\u003e\n"]]],["This document details retrieving multiple subscriptions via a `GET` request to `https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchGet`. The `packageName` is a mandatory path parameter. A `productIds[]` query parameter, containing up to 100 unique subscription IDs, is also required. The request body must be empty. A successful response includes a JSON object with a `subscriptions[]` field that lists requested subscriptions in the order they were requested. The operation requires the `androidpublisher` OAuth scope.\n"],null,["# Method: monetization.subscriptions.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.BatchGetSubscriptionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReads one or more subscriptions.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions: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 subscriptions should be retrieved. Must be equal to the packageName field on all the requests. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|-------------------------------------------------------------------------------------------------------------|\n| `productIds[]` | `string` Required. A list of up to 100 subscription product IDs to retrieve. All the IDs must be different. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for subscriptions.batchGet endpoint.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"subscriptions\": [ { object (/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription) } ] } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `subscriptions[]` | `object (`[Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription)`)` The list of requested subscriptions, 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`"]]
