Method: subscriptions.insert
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
创建或转移订阅。
使用订购新的客户账号方法为您订购的客户账号创建订阅。如需详细了解如何针对不同的付款方案创建订阅,请参阅管理订阅。\
如果您未使用客户插入方法订购客户的账号,请在为该客户创建订阅时使用客户的 customerAuthToken
。
如果要转移包含关联的 Google 云端硬盘或 Google 保险柜订阅的 G Suite 订阅,请使用批量操作来转移所有这些订阅。如需了解详情,请参阅如何转移订阅。
HTTP 请求
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions
网址采用 gRPC 转码语法。
路径参数
参数 |
customerId |
string
这可以是客户的主域名,也可以是客户的唯一标识符。如果客户的域名发生变化,则无法使用旧域名访问该客户,但可以随时使用客户的唯一标识符(由 API 返回)。我们建议您在系统中存储唯一标识符(如果适用)。
|
查询参数
参数 |
customerAuthToken |
string
创建转销账号时,必须提供 customerAuthToken 查询字符串,以便将直销客户的订阅转移到您的转销商账号,或将其他转销商客户的订阅转移到您的转销商账号。这是完成订阅转移所需的十六进制身份验证令牌。如需了解详情,请访问管理员帮助中心。
|
请求正文
请求正文包含一个 Subscription
实例。
响应正文
如果成功,响应正文将包含一个新创建的 Subscription
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/apps.order
如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):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)."]]