Method: subscriptions.insert

• HTTP リクエスト
• パスパラメータ
• クエリ パラメータ
• リクエストの本文
• レスポンスの本文
• 認証スコープ
• 試してみる

定期購入を作成または移行する。

新規のお客様アカウントを注文する方法を使用して、注文したお客様のアカウント用に定期購入を作成します。別のお支払いプラン向けに定期購入を作成する方法について詳しくは、定期購入の管理をご覧ください。

顧客挿入の方法を使用してお客様のアカウントを注文しなかった場合は、その顧客の定期購入を作成する際にその顧客の customerAuthToken を使用します。

関連する Google ドライブまたは Google Vault のサブスクリプションに関連付けられている G Suite サブスクリプションを移行する場合は、一括オペレーションを使用してこれらのサブスクリプションをすべて移行します。詳しくは、定期購入を移行する方法をご覧ください。

HTTP リクエスト

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId	string これは、顧客のプライマリ ドメイン名または顧客の一意の識別子のいずれかになります。顧客のドメイン名が変更された場合、古いドメイン名は顧客へのアクセスに使用できなくなりますが、顧客の一意の識別子（API から返されるもの）は常に使用できます。該当する場合は、システムに一意の識別子を保存することをおすすめします。

クエリ パラメータ

パラメータ
customerAuthToken	string 販売パートナー経由で購入されたアカウントを作成して直接顧客のサブスクリプションを移行する場合、または別の販売パートナー顧客のサブスクリプションを販売パートナーの管理に移行する場合は、customerAuthToken クエリ文字列が必要です。これは、定期購入の移行を完了するために必要な 16 進数の認証トークンです。詳しくは、管理者向けヘルプセンターをご覧ください。

リクエスト本文

リクエストの本文には Subscription のインスタンスが含まれています。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Subscription のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

• https://www.googleapis.com/auth/apps.order

詳細については、承認ガイドをご覧ください。