REST Resource: projects.locations.licenseConfigs

資源：LicenseConfig

使用者的授權相關資訊。

JSON 表示法 
{
  "name": string,
  "licenseCount": string,
  "subscriptionTier": enum (SubscriptionTier),
  "state": enum (State),
  "autoRenew": boolean,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "subscriptionTerm": enum (SubscriptionTerm),
  "freeTrial": boolean,
  "geminiBundle": boolean,
  "earlyTerminated": boolean,
  "earlyTerminationDate": {
    object (Date)
  },
  "lastUserUpdateTime": string
}
欄位
name

string

不可變動。ID。授權設定的完整資源名稱。格式：projects/{project}/locations/{location}/licenseConfigs/{licenseConfig}
licenseCount

string (int64 format)

這是必要旗標，購買的授權數量。
subscriptionTier

enum (SubscriptionTier)

這是必要旗標，授權設定的訂閱級別資訊。
state

enum (State)

僅供輸出。授權設定的狀態。
autoRenew

boolean

選用。授權設定是否應在到期時自動續約。
startDate

object (Date)

這是必要旗標，開始日期。
endDate

object (Date)

選用。預定結束日期。
subscriptionTerm

enum (SubscriptionTerm)

這是必要旗標，訂閱方案約期。
freeTrial

boolean

選用。授權設定是否適用於免費試用。
geminiBundle

boolean

僅供輸出。授權設定是否適用於 Gemini 套裝組合。
earlyTerminated

boolean

僅供輸出。指出訂閱方案是否在到期日前終止。一旦訂閱項目從 subsv3 終止，管道通常就會終止這項作業。
earlyTerminationDate

object (Date)

僅供輸出。訂閱方案在到期日前終止的日期。
lastUserUpdateTime

string (Timestamp format)

選用。最近一次使用者發起的更新時間戳記 (座位數變更或訂閱方案期限變更)。與 updateTime 不同，這個欄位只會在客戶明確更新授權時 (例如透過使用者介面) 蓋上時間戳記，系統驅動的寫入作業 (訂閱管道、BALC 傳播等) 則不會觸及這個欄位。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

狀態

授權設定狀態列舉。

列舉
STATE_UNSPECIFIED 預設值。授權設定不存在。
ACTIVE 授權設定有效且正在使用中。
EXPIRED 授權設定已過期。
NOT_STARTED 授權設定尚未開始，且開始日期為未來的時間。
WITHDRAWN 也就是子授權設定已將所有席位退回所屬的 BillingAccountLicenseConfig。與「已過期」類似。
DEACTIVATING 授權設定處於寬限期。訂閱方案已終止 (提前終止或到期)，但客戶仍可在一段時間內存取。寬限期結束後，就會變成「已過期」。

SubscriptionTerm

訂閱方案約期。

列舉
SUBSCRIPTION_TERM_UNSPECIFIED 預設值，請勿使用。
SUBSCRIPTION_TERM_ONE_MONTH 1 個月。
SUBSCRIPTION_TERM_ONE_YEAR 1 年。
SUBSCRIPTION_TERM_THREE_YEARS 3 年。
SUBSCRIPTION_TERM_CUSTOM 自訂字詞。必須設定 endDate。

方法

create

 建立 LicenseConfig。這個方法只能用於建立 NotebookLM 授權或 Gemini Enterprise 免費試用授權。

get

 取得 LicenseConfig。

list

 列出與專案相關聯的所有 LicenseConfig。

patch

 更新 LicenseConfig