Method: monetization.subscriptions.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک اشتراک جدید ایجاد می کند. طرح های پایه جدید اضافه شده تا زمانی که فعال شوند در حالت پیش نویس باقی خواهند ماند.
درخواست HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
packageName | string ضروری. برنامه والد (نام بسته) که اشتراک باید برای آن ایجاد شود. باید برابر با قسمت packageName در منبع اشتراک باشد. |
پارامترهای پرس و جو
| مولفه های |
|---|
productId | string ضروری. شناسه مورد استفاده برای اشتراک. برای الزامات مربوط به این قالب، به مستندات فیلد productId در منبع اشتراک مراجعه کنید. |
regionsVersion | object ( RegionsVersion ) ضروری. نسخه مناطق موجود که برای اشتراک استفاده می شود. |
درخواست بدن
بدنه درخواست شامل نمونه ای از Subscription است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از Subscription است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidpublisher
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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`"]]
