Method: subscriptions.insert
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ایجاد یا انتقال اشتراک.
اشتراکی برای حساب مشتری که با استفاده از روش سفارش یک حساب مشتری جدید سفارش داده اید ایجاد کنید. برای اطلاعات بیشتر درباره ایجاد اشتراک برای طرح‌های پرداخت مختلف، به مدیریت اشتراک‌ها مراجعه کنید.\
اگر حساب مشتری را با استفاده از روش درج مشتری سفارش ندادید، هنگام ایجاد اشتراک برای آن مشتری، از customerAuthToken مشتری استفاده کنید.
اگر اشتراک G Suite را با اشتراک Google Drive یا Google Vault منتقل می‌کنید، از عملیات دسته‌ای برای انتقال همه این اشتراک‌ها استفاده کنید. برای اطلاعات بیشتر، نحوه انتقال اشتراک را ببینید.
درخواست HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
customerId | string این می تواند نام دامنه اصلی مشتری یا شناسه منحصر به فرد مشتری باشد. اگر نام دامنه برای یک مشتری تغییر کند، نام دامنه قدیمی را نمی توان برای دسترسی به مشتری استفاده کرد، اما شناسه منحصر به فرد مشتری (که توسط API برگردانده شده است) همیشه می تواند استفاده شود. توصیه می کنیم شناسه منحصر به فرد را در صورت لزوم در سیستم های خود ذخیره کنید. |
پارامترهای پرس و جو
| پارامترها |
|---|
customerAuthToken | string رشته پرس و جو customerAuthToken هنگام ایجاد یک حساب فروش مجدد که اشتراک مستقیم مشتری را منتقل می کند یا اشتراک مشتری فروشنده دیگری را به مدیریت فروشنده شما منتقل می کند، مورد نیاز است. این یک نشانه احراز هویت هگزادسیمال است که برای تکمیل انتقال اشتراک مورد نیاز است. برای اطلاعات بیشتر، به مرکز راهنمایی سرپرست مراجعه کنید. |
درخواست بدن
بدنه درخواست شامل نمونه ای از Subscription است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از Subscription است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/apps.order
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: subscriptions.insert\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 or transfer a subscription.\n\nCreate a subscription for a customer's account that you ordered using the [Order a new customer account](/workspace/admin/reseller/v1/reference/customers/insert) method. For more information about creating a subscription for different payment plans, see [manage subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#create_subscription).\\\\\n\nIf you did not order the customer's account using the customer insert method, use the customer's `customerAuthToken` when creating a subscription for that customer.\n\nIf transferring a G Suite subscription with an associated Google Drive or Google Vault subscription, use the [batch operation](/workspace/admin/reseller/v1/how-tos/batch) to transfer all of these subscriptions. For more information, see how to [transfer subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#transfer_a_subscription).\n\n### HTTP request\n\n`POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` This can be either the customer's primary domain name or the customer's unique identifier. If the domain name for a customer changes, the old domain name cannot be used to access the customer, but the customer's unique identifier (as returned by the API) can always be used. We recommend storing the unique identifier in your systems where applicable. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerAuthToken` | `string` The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the [administrator help center](//support.google.com/a/bin/answer.py?answer=142336). |\n\n### Request body\n\nThe request body contains an instance of [Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
