Method: applications.deviceTierConfigs.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
傳回已建立的裝置層級設定 (依遞減建立時間排序)。
HTTP 要求
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/deviceTierConfigs
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
packageName |
string
應用程式的套件名稱。
|
查詢參數
| 參數 |
pageSize |
integer
要傳回的裝置層級設定數量上限。服務傳回的產品數量可能會少於這個值。如未指定，系統最多會傳回 10 項裝置層級設定。這個欄位的最大值為 100；超過 100 個值會強制轉換為 100。裝置層級設定會按照建立時間遞減排序。
|
pageToken |
string
屬於接收自前一個 deviceTierConfigs.list 呼叫的網頁權杖。提供此項目即可擷取後續網頁。
|
回應主體
列出現有裝置層級設定的回應。
如果成功，回應主體會含有以下結構的資料：
| JSON 表示法 |
{
"deviceTierConfigs": [
{
object (DeviceTierConfig)
}
],
"nextPageToken": string
} |
| 欄位 |
deviceTierConfigs[] |
object (DeviceTierConfig)
開發人員建立的裝置層級設定，
|
nextPageToken |
string
可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。
|
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/androidpublisher
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eReturns a list of device tier configs for a specified Android app, ordered by descending creation time.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to retrieve large lists of device tier configs.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eRequest body should be empty, and the response includes a list of device tier configs and a token for pagination.\u003c/p\u003e\n"]]],["This API retrieves a list of device tier configurations for a specified Android app. It uses a `GET` request to a URL with the app's package name as a path parameter. Optional query parameters `pageSize` (up to 100) and `pageToken` facilitate pagination. The request body is empty. The response, ordered by creation time, is a JSON object containing an array of `deviceTierConfigs` and a `nextPageToken` for further pages. It needs `androidpublisher` authorization scope.\n"],null,["# Method: applications.deviceTierConfigs.list\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.ListDeviceTierConfigsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns created device tier configs, ordered by descending creation time.\n\n### HTTP request\n\n`GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/deviceTierConfigs`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-----------------------------------|\n| `packageName` | `string` Package name of the app. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of device tier configs to return. The service may return fewer than this value. If unspecified, at most 10 device tier configs will be returned. The maximum value for this field is 100; values above 100 will be coerced to 100. Device tier configs will be ordered by descending creation time. |\n| `pageToken` | `string` A page token, received from a previous `deviceTierConfigs.list` call. Provide this to retrieve the subsequent page. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse listing existing device tier configs.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deviceTierConfigs\": [ { object (/android-publisher/api-ref/rest/v3/applications.deviceTierConfigs#DeviceTierConfig) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deviceTierConfigs[]` | `object (`[DeviceTierConfig](/android-publisher/api-ref/rest/v3/applications.deviceTierConfigs#DeviceTierConfig)`)` Device tier configs created by the developer. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
