Method: edits.tracks.create
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
packageName |
string
必要欄位。應用程式的套件名稱。
|
editId |
string
必要欄位。編輯內容的 ID。
|
要求主體
要求主體包含 TrackConfig
的例項。
回應主體
如果成功,回應主體會包含新建立的 Track
例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/androidpublisher
TrackConfig
欄位 |
track |
string
必要欄位。新測試群組的 ID。 如為預設測試群組,這個欄位只會包含軌跡別名。 板型規格軌道會使用特殊前置字元做為 ID,例如 wear:production 、automotive:production 。如果不是預設音軌,這個前置字串必須與 formFactor 欄位的值相符。 進一步瞭解測試群組名稱
|
type |
enum (TrackType )
必要欄位。新測試群組的類型。 目前唯一支援的值是 ClosedTesting。
|
formFactor |
enum (FormFactor )
必要欄位。新測試群組的板型規格。預設為預設音軌。
|
TrackType
列舉 |
TRACK_TYPE_UNSPECIFIED |
備用值,請勿使用。 |
CLOSED_TESTING |
封閉測試群組。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eThis operation creates a new track for an Android application using the provided configurations.\u003c/p\u003e\n"],["\u003cp\u003eIt requires a \u003ccode\u003ePOST\u003c/code\u003e request to a specific URL, including the package name and edit ID.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain the new track's configuration, such as its identifier, type, and form factor.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful execution results in the response body containing the newly created track details.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope is necessary.\u003c/p\u003e\n"]]],["This document outlines how to create a new track using the Android Publisher API. The `POST` request is sent to `https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks`, with the package name and edit ID as path parameters. The request body requires a `TrackConfig` instance, defining the track's `track`, `type` (currently only `CLOSED_TESTING` is supported), and `formFactor` (default, `WEAR`, or `AUTOMOTIVE`). The response will be a newly created `Track` instance. Authorization requires the `https://www.googleapis.com/auth/androidpublisher` scope.\n"],null,["# Method: edits.tracks.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [TrackConfig](#TrackConfig)\n - [JSON representation](#TrackConfig.SCHEMA_REPRESENTATION)\n- [TrackType](#TrackType)\n- [FormFactor](#FormFactor)\n- [Try it!](#try-it)\n\nCreates a new track.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/edits/{editId}/tracks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|---------------------------------------------|\n| `packageName` | `string` Required. Package name of the app. |\n| `editId` | `string` Required. Identifier of the edit. |\n\n### Request body\n\nThe request body contains an instance of [TrackConfig](/android-publisher/api-ref/rest/v3/edits.tracks/create#TrackConfig).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Track](/android-publisher/api-ref/rest/v3/edits.tracks#Track).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nTrackConfig\n-----------\n\nConfigurations of the new track.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"track\": string, \"type\": enum (/android-publisher/api-ref/rest/v3/edits.tracks/create#TrackType), \"formFactor\": enum (/android-publisher/api-ref/rest/v3/edits.tracks/create#FormFactor) } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `track` | `string` Required. Identifier of the new track. For default tracks, this field consists of the track alias only. Form factor tracks have a special prefix as an identifier, for example `wear:production`, `automotive:production`. This prefix must match the value of the `formFactor` field, if it is not a default track. [More on track name](https://developers.google.com/android-publisher/tracks#ff-track-name) |\n| `type` | `enum (`[TrackType](/android-publisher/api-ref/rest/v3/edits.tracks/create#TrackType)`)` Required. Type of the new track. Currently, the only supported value is closedTesting. |\n| `formFactor` | `enum (`[FormFactor](/android-publisher/api-ref/rest/v3/edits.tracks/create#FormFactor)`)` Required. Form factor of the new track. Defaults to the default track. |\n\nTrackType\n---------\n\nAvailable types for the new track.\n\n| Enums ||\n|--------------------------|-----------------------------|\n| `TRACK_TYPE_UNSPECIFIED` | Fallback value, do not use. |\n| `CLOSED_TESTING` | Closed testing track. |\n\nFormFactor\n----------\n\nAvailable form factors for the new track.\n\n| Enums ||\n|---------------------------|-------------------------------|\n| `FORM_FACTOR_UNSPECIFIED` | Fallback value, do not use. |\n| `DEFAULT` | Default track. |\n| `WEAR` | Wear form factor track. |\n| `AUTOMOTIVE` | Automotive form factor track. |"]]