Method: monetization.subscriptions.create
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
建立新訂閱項目。在啟用前，新增的基本方案會維持在草稿狀態。
HTTP 要求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
packageName |
string
必要欄位。應建立訂閱項目的父項應用程式 (套件名稱)。必須等於訂閱資源中的 packageName 欄位。
|
查詢參數
| 參數 |
productId |
string
必要欄位。要用於訂閱項目的 ID，如要瞭解這種格式的規定，請參閱訂閱資源中「productId」欄位的說明文件。
|
regionsVersion |
object (RegionsVersion)
必要欄位。訂閱項目在適用區域的版本。
|
要求主體
要求主體包含 Subscription 的例項。
回應主體
如果成功，回應主體會包含新建立的 Subscription 例項。
授權範圍
需要下列 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\u003eCreates a new subscription for a specified Android app package.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the package name, subscription ID, and regions version in the request.\u003c/p\u003e\n"],["\u003cp\u003eThe newly created subscription will initially be in draft state and needs to be activated.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain a \u003ccode\u003eSubscription\u003c/code\u003e resource, and a successful response will return the newly created \u003ccode\u003eSubscription\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document details how to create a new subscription using the Android Publisher API. A `POST` request is sent to a specified URL, including the `packageName` in the path. The request requires `productId` and `regionsVersion` as query parameters. The request body contains the `Subscription` to be created. A successful response returns a newly created `Subscription`. The process uses gRPC Transcoding and requires the `androidpublisher` OAuth scope. Newly added base plans are in draft until activated.\n"],null,["# Method: monetization.subscriptions.create\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new subscription. Newly added base plans will remain in draft state until activated.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions`\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 subscription should be created. Must be equal to the packageName field on the Subscription resource. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `productId` | `string` Required. The ID to use for the subscription. For the requirements on this format, see the documentation of the productId field on the Subscription resource. |\n| `regionsVersion` | `object (`[RegionsVersion](/android-publisher/api-ref/rest/v3/RegionsVersion)`)` Required. The version of the available regions being used for the subscription. |\n\n### Request body\n\nThe request body contains an instance of [Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Subscription](/android-publisher/api-ref/rest/v3/monetization.subscriptions#Subscription).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
