Method: subscriptions.insert
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
サブスクリプションを作成または転送します。
新しいお客様アカウントを注文するメソッドを使用して、注文したお客様のアカウントのサブスクリプションを作成します。さまざまなお支払いプランのサブスクリプションを作成する方法については、サブスクリプションを管理するをご覧ください。
お客様のアカウントをお客様挿入方法で注文しなかった場合は、そのお客様の定期購入を作成するときにお客様の customerAuthToken
を使用します。
関連する Google ドライブまたは Google Vault サブスクリプションとともに G Suite サブスクリプションを移行する場合は、バッチ オペレーションを使用して、これらのサブスクリプションをすべて移行します。詳しくは、定期購入を移行する方法をご覧ください。
HTTP リクエスト
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
customerId |
string
顧客のメインのドメイン名または顧客の一意の ID を指定できます。お客様のドメイン名が変更された場合、古いドメイン名を使用してお客様にアクセスすることはできませんが、(API から返された)お客様の一意の識別子は常に使用できます。必要に応じて、一意の識別子をシステムに保存することをおすすめします。
|
クエリ パラメータ
パラメータ |
customerAuthToken |
string
customerAuthToken クエリ文字列は、直接契約のお客様のサブスクリプションを移行する、または別の販売パートナーのお客様のサブスクリプションを販売パートナーの管理下に移行する再販アカウントを作成する場合に必要です。これは、定期購入の移行を完了するために必要な 16 進数認証トークンです。詳しくは、管理者向けヘルプセンターをご覧ください。
|
リクエストの本文
リクエストの本文には Subscription
のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Subscription
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/apps.order
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],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)."]]