REST Resource: projects

资源：项目

服务中 Google Cloud 项目的元数据和配置。

JSON 表示法 
{
  "name": string,
  "createTime": string,
  "provisionCompletionTime": string,
  "serviceTermsMap": {
    string: {
      object (ServiceTerms)
    },
    ...
  },
  "customerProvidedConfig": {
    object (CustomerProvidedConfig)
  },
  "configurableBillingStatus": {
    object (ConfigurableBillingStatus)
  }
}
字段
name

string

仅限输出。项目的完整资源名称，例如 projects/{project}。请注意，在发出请求时，项目编号和项目 ID 均可接受，但服务器的响应将始终采用项目编号的形式。
createTime

string (Timestamp format)

仅限输出。此项目的创建时间戳。

采用 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"。
provisionCompletionTime

string (Timestamp format)

仅限输出。此项目成功配置的时间戳。空值表示相应项目仍在预配中，尚未准备就绪，无法使用。

采用 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"。
serviceTermsMap

map (key: string, value: object (ServiceTerms))

仅限输出。服务条款的映射。键是 ServiceTerms 的 id。
customerProvidedConfig

object (CustomerProvidedConfig)

可选。客户提供的配置。
configurableBillingStatus

object (ConfigurableBillingStatus)

仅限输出。项目可配置结算的当前状态。

ServiceTerms

有关服务条款的元数据。

JSON 表示法 
{
  "id": string,
  "version": string,
  "state": enum (State),
  "acceptTime": string,
  "declineTime": string
}
字段
id

string

相应服务条款的唯一标识符。可用的条款：
version

string

服务条款的版本字符串。如需了解可接受的值，请参阅上文针对 id 的注释。
state

enum (State)

项目是否已接受/拒绝服务条款，或者是否仍处于待处理状态。
acceptTime

string (Timestamp format)

项目上次同意服务条款的时间。

采用 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"。
declineTime

string (Timestamp format)

项目上次拒绝或撤消服务条款协议的时间。

采用 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 枚举的默认值。此值实际上并未被使用。
TERMS_ACCEPTED 项目已同意服务条款。
TERMS_PENDING 项目尚待审核并接受服务条款。
TERMS_DECLINED 相应项目已拒绝或撤消服务条款协议。

CustomerProvidedConfig

客户提供的配置。

JSON 表示法 
{
  "notebooklmConfig": {
    object (NotebooklmConfig)
  }
}
字段
notebooklmConfig

object (NotebooklmConfig)

可选。NotebookLM 设置的配置。

NotebooklmConfig

NotebookLM 的配置。

JSON 表示法 
{
  "modelArmorConfig": {
    object (ModelArmorConfig)
  },
  "optOutNotebookSharing": boolean,
  "dataProtectionPolicy": {
    object (DataProtectionPolicy)
  },
  "observabilityConfig": {
    object (ObservabilityConfig)
  }
}
字段
modelArmorConfig

object (ModelArmorConfig)

用于净化用户提示和 LLM 回答的 Model Armor 配置。
optOutNotebookSharing

boolean

可选。是否为项目停用笔记本共享功能。如果未指定，则默认为 false。
dataProtectionPolicy

object (DataProtectionPolicy)

可选。指定 NotebookLM 的数据保护政策。
observabilityConfig

object (ObservabilityConfig)

可选。NotebookLM 的可观测性配置。

ModelArmorConfig

客户定义的 Model Armor 模板的配置，用于净化用户提示和 LLM 回答。

JSON 表示法 
{
  "userPromptTemplate": string,
  "responseTemplate": string
}
字段
userPromptTemplate

string

可选。用于清理用户提示的 Model Armor 模板的资源名称。格式：projects/{project}/locations/{location}/templates/{templateId}。如果未指定，系统将不会对用户提示进行净化处理。
responseTemplate

string

可选。用于清理 LLM 回答的 Model Armor 模板的资源名称。格式：projects/{project}/locations/{location}/templates/{templateId}。如果未指定，系统将不会对 LLM 回答进行净化处理。

DataProtectionPolicy

NotebookLM 的数据保护政策配置。

JSON 表示法 
{
  "sensitiveDataProtectionPolicy": {
    object (SensitiveDataProtectionPolicy)
  }
}
字段
sensitiveDataProtectionPolicy

object (SensitiveDataProtectionPolicy)

可选。敏感数据保护政策。

SensitiveDataProtectionPolicy

指定 Sensitive Data Protection (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview) 政策。

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

string

可选。Sensitive Data Protection 政策资源名称。

ConfigurableBillingStatus

表示当前有效的可配置结算参数。这些值源自内部存储的客户订阅历史记录，反映了在调用 projects.get 时正用于结算的阈值。这包括订阅的 startTime，并且由于结算规则（例如，降价仅在新月份开始时生效），可能与 customerProvidedConfig 中的值不同。我们还添加了更新类型，以指示在 projects.patch 操作中对可配置的结算配置执行的更新类型。

JSON 表示法 
{
  "effectiveSearchQpmThreshold": string,
  "effectiveIndexingCoreThreshold": string,
  "startTime": string,
  "terminateTime": string,
  "searchQpmThresholdNextUpdateTime": string,
  "indexingCoreThresholdNextUpdateTime": string,
  "updateType": enum (UpdateType),
  "agentSearchTokenSubscriptionStatuses": [
    {
      object (AgentSearchTokenSubscriptionStatus)
    }
  ]
}
字段
effectiveSearchQpmThreshold

string (int64 format)

可选。当前有效的搜索 QPM 阈值（以每分钟查询次数为单位）。这是用于超额计算的 QPM 用量比较阈值。
effectiveIndexingCoreThreshold

string (int64 format)

可选。当前有效的索引核心阈值。此阈值用于比较索引核心用量，以便计算超额费用。
startTime

string (Timestamp format)

可选。当前有效结算订阅的开始时间。

采用 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"。
terminateTime

string (Timestamp format)

仅限输出。搜索 QPM 和索引核心订阅的最新终止生效时间。

采用 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"。
searchQpmThresholdNextUpdateTime

string (Timestamp format)

仅限输出。搜索 QPM 订阅阈值的最早下次更新时间。此值基于底层 Cloud Billing Subscription V3 API 返回的 next_update_time。仅当更新 QPM 订阅阈值的请求成功时，系统才会填充此字段。

采用 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"。
indexingCoreThresholdNextUpdateTime

string (Timestamp format)

仅限输出。索引编制核心订阅阈值的最早下次更新时间。此值基于底层 Cloud Billing Subscription V3 API 返回的 next_update_time。仅当更新索引核心订阅阈值请求成功时，系统才会填充此字段。

采用 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"。
updateType

enum (UpdateType)

仅限输出。相应操作中执行的更新类型。此字段填充在 projects.patch 的响应中。
agentSearchTokenSubscriptionStatuses[]

object (AgentSearchTokenSubscriptionStatus)

仅限输出。各模型的 Agent Search TPM 订阅状态。

UpdateType

对可配置结算配置执行的更新类型。

枚举
UPDATE_TYPE_UNSPECIFIED 未指定的更新类型。
CREATE 已创建/启用可配置结算。
DELETE 可配置的结算已被删除/停用。
SCALE_UP 订阅已升级（阈值已提高）。
SCALE_DOWN 订阅已缩减（阈值已降低）。

AgentSearchTokenSubscriptionStatus

各型号的 Agent Search TPM 订阅状态。客户提供的配置中每个有效 coreSubscription.agent_search_token_subscriptions[*] 条目对应一个条目；由 projects.patch 和 projects.get 填充。

此消息中的生命周期标量（startTime、terminateTime、updateType、tpmThresholdNextUpdateTime）是针对（项目、模型版本）的，与封装的可配置结算状态中的整体关系 startTime / terminateTime / updateType 类似，但范围限定为此特定的 Agent Search TPM 订阅，而不是整体客户可配置价格关系。这种按实例划分的精细度是有意为之：底层 SubV3 存储空间是按（项目、modelVersion）划分的，因此每个模型都有自己的激活、终止和延迟更新时钟；在响应中显示这些信息可为客户提供所需的精细度，以便他们独立管理每个模型的承诺。QPM / IndexingCore 不同 - 它们的存储空间是每个（项目、位置）一行，因此它们的生命周期仅由 ConfigurableBillingStatus 上的整体关系标量表示。

JSON 表示法 
{
  "modelVersion": string,
  "effectiveTpmThreshold": string,
  "tpmThresholdNextUpdateTime": string,
  "startTime": string,
  "terminateTime": string,
  "updateType": enum (UpdateType)
}
字段
modelVersion

string

仅限输出。相应状态对应的 Gemini 模型版本。与 CoreSubscription.AgentSearchTokenSubscription.model_version（Gemini Enterprise Agent Platform 模型版本注册表中的稳定 Gemini 模型版本；请参阅 https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models)相匹配。
effectiveTpmThreshold

string (int64 format)

仅限输出。当前有效的 TPM 阈值。立即反映扩容，并在下一个结算周期反映缩容，与 effectiveSearchQpmThreshold 语义保持一致。
tpmThresholdNextUpdateTime

string (Timestamp format)

仅限输出。相应（项目、modelVersion）的 TPM 订阅阈值的最早下一次更新时间。仅在成功更新后填充。

采用 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"。
startTime

string (Timestamp format)

仅限输出。相应（项目、modelVersion）代理搜索 TPM 订阅首次激活的时间。在首次激活此模型版本时设置一次，后续阈值更新不会更改此值；在终止并重新激活时，系统会记录一个新值。不会将整个关系 startTime 移至封装的 ConfigurableBillingStatus，后者继续表示客户可配置价格关系的首次激活。

采用 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"。
terminateTime

string (Timestamp format)

仅限输出。如果已设置，则表示此（项目、modelVersion）Agent Search TPM 订阅将终止的预定生效时间。当客户从 coreSubscription.agent_search_token_subscriptions[*] 中移除相应条目时填充。不会移动封装的可配置结算状态中的整个关系 terminateTime，只有在整个客户可配置价格关系被拆除时才会填充该关系。

采用 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"。
updateType

enum (UpdateType)

仅限输出。相应（项目、modelVersion）订阅的最新更新类型，由最新的 projects.patch 调用执行。UPDATE_TYPE_UNSPECIFIED 表示此 modelVersion 未受最新项目补丁的影响（其 effectiveTpmThreshold 反映的是较早的更新）。封装的可配置结算状态上的整个关系 updateType 继续总结项目（QPM、IndexingCore 和 Agent Search TPM）中所有平台上的最新更新方向。

方法

get

 获取 Project。

patch

 更新 Discovery Engine 项目的可修改设置。

provision

 预配项目资源。

reportConsentChange

 更新相应项目的服务条款。