Method: orders.batchget
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
orders.get:取得訂單清單的訂單詳細資料。
HTTP 要求
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders:batchGet
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
packageName |
string
必要欄位。購買這項訂閱項目或應用程式內商品時所用的應用程式套件名稱 (例如「com.some.thing」)。
|
查詢參數
參數 |
orderIds[] |
string
必要欄位。要擷取訂單詳細資料的訂單 ID 清單。每個要求必須包含 1 到 1000 個訂單 ID (含首尾)。如果找不到任何訂單 ID,或與提供的套件不符,整個要求就會失敗並顯示錯誤。訂單 ID 不得重複。
|
回應主體
orders.batchGet API 的回應。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
{
"orders": [
{
object (Order )
}
]
} |
欄位 |
orders[] |
object (Order )
所要求訂單 ID 的詳細資料。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/androidpublisher
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[],[],null,["# Method: orders.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.BatchGetOrdersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\norders.get order details for a list of orders.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders: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 package name of the application for which this subscription or in-app item was purchased (for example, 'com.some.thing'). |\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `orderIds[]` | `string` Required. The list of order IDs to retrieve order details for. There must be between 1 and 1000 (inclusive) order IDs per request. If any order ID is not found or does not match the provided package, the entire request will fail with an error. The order IDs must be distinct. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the orders.batchGet API.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------|\n| ``` { \"orders\": [ { object (/android-publisher/api-ref/rest/v3/orders#Order) } ] } ``` |\n\n| Fields ||\n|------------|------------------------------------------------------------------------------------------------------------|\n| `orders[]` | `object (`[Order](/android-publisher/api-ref/rest/v3/orders#Order)`)` Details for the requested order IDs. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]