Method: subscriptions.insert

建立或轉移訂閱項目。

為使用訂購新客戶帳戶方法訂購的客戶帳戶建立訂閱項目。如要進一步瞭解如何為不同付款方案建立訂閱項目,請參閱「管理訂閱項目」。

如果您未使用客戶插入方法訂購客戶帳戶,請在為該客戶建立訂閱項目時使用客戶的 customerAuthToken

如果要轉移含有相關聯 Google 雲端硬碟或 Google 保管箱訂閱項目的 G Suite 訂閱項目,請使用批次作業轉移所有這些訂閱項目。詳情請參閱如何轉移訂閱項目

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

這可以是客戶的主網域名稱,或客戶的專屬 ID。如果客戶的網域名稱有所變更,您就無法使用舊網域名稱存取客戶,但您隨時可以使用客戶的專屬 ID (由 API 傳回)。建議您在適用的情況下,將專屬 ID 儲存在系統中。

查詢參數

參數
customerAuthToken

string

如要建立轉售帳戶,以便轉移直接客戶的訂閱項目,或將其他經銷商客戶的訂閱項目轉移至您的經銷商管理系統,就必須使用 customerAuthToken 查詢字串。這是完成訂閱轉移作業所需的十六進位驗證權杖。詳情請參閱管理員說明中心

要求主體

要求主體包含 Subscription 的例項。

回應主體

如果成功,回應主體會包含新建立的 Subscription 例項。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南