Method: subscriptions.changeSeats
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
更新訂閱項目的使用者授權設定。
如要進一步瞭解如何更新年約方案或彈性方案訂閱方案的授權,請參閱「管理訂閱項目」。
HTTP 要求
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changeSeats
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
customerId |
string
這可以是客戶的主網域名稱,或客戶的專屬 ID。如果客戶的網域名稱有所變更,您就無法使用舊網域名稱存取客戶,但您隨時可以使用客戶的專屬 ID (由 API 傳回)。建議您在適用的情況下,將專屬 ID 儲存在系統中。
|
subscriptionId |
string
這是必要屬性。subscriptionId 是訂閱 ID,每位客戶皆有專屬 ID。由於訂閱項目更新時,subscriptionId 會有所變更,因此建議您不要將此 ID 用於永久性資料的索引鍵。您可以使用擷取所有經銷商訂閱項目方法找到 subscriptionId 。
|
回應主體
如果成功,回應主體會包含 Subscription
的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/apps.order
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],null,["# Method: subscriptions.changeSeats\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a subscription's user license settings.\n\nFor more information about updating an annual commitment plan or a flexible plan subscription's licenses, see [Manage Subscriptions](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_subscriptions#update_subscription_seat).\n\n### HTTP request\n\n`POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changeSeats`\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| `subscriptionId` | `string` This is a required property. The `subscriptionId` is the subscription identifier and is unique for each customer. Since a `subscriptionId` changes when a subscription is updated, we recommend to not use this ID as a key for persistent data. And the `subscriptionId` can be found using the [retrieve all reseller subscriptions](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_subscriptions#get_all_subscriptions) method. |\n\n### Request body\n\nThe request body contains an instance of [Seats](/workspace/admin/reseller/reference/rest/v1/subscriptions#Seats).\n\n### Response body\n\nIf successful, the response body contains an 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)."]]