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,
  "alertPolicyResourceConfig": {
    object (AlertPolicyResourceConfig)
  },
  "geminiBundle": boolean,
  "earlyTerminated": boolean,
  "earlyTerminationDate": {
    object (Date)
  },
  "lastUserUpdateTime": string
}
字段
name

string

不可变。标识符。许可配置的完全限定资源名称。格式：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

可选。许可配置是否支持免费试用。
alertPolicyResourceConfig

object (AlertPolicyResourceConfig)

可选。相应许可配置的提醒政策配置。
geminiBundle

boolean

仅限输出。许可配置是否适用于 Gemini 软件包。
earlyTerminated

boolean

仅限输出。指示订阅是否在到期日期之前终止。一旦订阅从 subsv3 终止，流水线通常也会终止此会话。
earlyTerminationDate

object (Date)

仅限输出。订阅提前终止的日期（早于到期日期）。
lastUserUpdateTime

string (Timestamp format)

可选。用户发起的最新更新（席位数量变更或订阅期限变更）的时间戳。与 updateTime 不同，此字段仅在客户明确更新许可（例如通过界面）时盖上时间戳，并且不受系统驱动的写入（订阅流水线、BALC 传播等）的影响。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 时，就会出现这种情况。与 EXPIRED 类似。
DEACTIVATING 许可配置在到期日期之前终止，并且正在停用。客户在此状态下仍可访问。在停用期结束（14 天）或达到结束日期后（以先到者为准），该广告系列将转换为“已过期”状态。

AlertPolicyResourceConfig

资源级提醒配置。使用位置：* UserLicense * EngineUserData；数据连接器中的 AlertPolicyConfig 用途相同。没有简单的迁移方式。

JSON 表示法 
{
  "alertPolicy": string,
  "alertEnrollments": [
    {
      object (AlertEnrollment)
    }
  ],
  "contactDetails": [
    {
      object (ContactDetails)
    }
  ],
  "languageCode": string,
  "regionCode": string
}
字段
alertPolicy

string

不可变。AlertPolicy 的完全限定资源名称。
alertEnrollments[]

object (AlertEnrollment)

可选。每个提醒的注册状态。
contactDetails[]

object (ContactDetails)

可选。每个提醒政策的详细联系信息。
languageCode

string

可选。用于通知的语言代码
regionCode

string

可选。订阅相应提醒政策的用户的所用区域代码。

AlertEnrollment

提醒注册状态。

JSON 表示法 
{
  "alertId": string,
  "enrollState": enum (EnrollState),
  "notificationParams": {
    string: string,
    ...
  }
}
字段
alertId

string

不可变。提醒的 ID。
enrollState

enum (EnrollState)

必需。客户的注册状态。
notificationParams

map (key: string, value: string)

可选。用于实例化通知的参数。用于在注册时触发的通知。未存储。* Gemini Business 欢迎邮件。* Gemini Business 用户邀请邮件。

EnrollState

提醒的注册状态枚举。

枚举
ENROLL_STATE_UNSPECIFIED 默认值。适用于尚未对提醒政策做出响应的客户。
ENROLLED 客户已注册此政策。
DECLINED 客户已拒绝此政策。

ContactDetails

存储在资源级层的联系信息。如果项目级和资源级联系信息均已填充，则资源级联系信息将替换项目级联系信息。

JSON 表示法 
{
  "emailAddress": string
}
字段
emailAddress

string

可选。联系人的邮箱。

方法

create

 创建 LicenseConfig。此方法应仅用于创建 NotebookLm 许可或 Gemini Enterprise 免费试用许可。

get

 获取 LicenseConfig。

list

 列出与项目关联的所有 LicenseConfig。

patch

 更新 LicenseConfig。