Method: monetization.subscriptions.batchGet
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchGet
网址采用 gRPC 转码语法。
路径参数
参数 |
packageName |
string
必需。要为其检索订阅的父应用(软件包名称)。必须等于所有请求中的 packageName 字段。
|
查询参数
参数 |
productIds[] |
string
必需。要检索的订阅产品 ID 的列表(最多 100 个)。所有 ID 不能相同。
|
响应正文
subscription.batchGet 端点的响应消息。
如果成功,响应正文将包含结构如下的数据:
字段 |
subscriptions[] |
object (Subscription )
请求的订阅列表,与请求的顺序相同。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/androidpublisher
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):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`"]]