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 正規化，並使用 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 正規化，並使用 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

這項服務條款的專屬 ID。可用的字詞：
version

string

服務條款的版本字串。如需可接受的值，請參閱上方的 id 註解。
state

enum (State)

專案是否已接受/拒絕服務條款，或仍在等待回應。
acceptTime

string (Timestamp format)

專案上次同意服務條款的時間。

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

string (Timestamp format)

專案上次拒絕或撤銷服務條款協議的時間。

使用 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 列舉的預設值。這個值不會實際使用。
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)

選用。Sensitive Data Protection 政策。

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

代表目前有效的可設定帳單參數。這些值是根據內部儲存的客戶訂閱記錄衍生而來，並反映在專案的 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 正規化，並使用 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 正規化，並使用 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 正規化，並使用 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 正規化，並使用 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

每個模型代理程式搜尋的 TPM 訂閱狀態。每個有效 coreSubscription.agent_search_token_subscriptions[*] 項目在客戶提供的設定中各有一筆項目；由 projects.patch 和 projects.get 填入。

這則訊息的生命週期純量 (startTime、terminateTime、updateType、tpmThresholdNextUpdateTime) 是以 (專案、modelVersion) 為單位，屬於封閉式 ConfigurableBillingStatus 中整個關係的 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 正規化，並使用 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) Agent Search TPM 訂閱項目時。首次啟用這個模型版本時設定一次，後續更新門檻時不會變更；終止並重新啟用時，系統會記錄新值。不會移動封閉式 ConfigurableBillingStatus 的整個關係 startTime，後者會繼續代表整體客戶可設定價格關係的首次啟用。

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

string (Timestamp format)

僅供輸出。如果已設定，這個 (專案、modelVersion) Agent Search TPM 訂閱方案將在排定的生效時間終止。如果顧客從 coreSubscription.agent_search_token_subscriptions[*] 移除這個項目，系統就會填入這個欄位。不會移動封閉式 ConfigurableBillingStatus 中的整個關係 terminateTime，只有在整個客戶可設定價格的關係遭到終止時，才會填入這個值。

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

enum (UpdateType)

僅供輸出。這個 (專案、modelVersion) 訂閱項目的最新更新類型，由最新的 projects.patch 呼叫執行。UPDATE_TYPE_UNSPECIFIED 表示最新專案修補程式未觸及這個 modelVersion (其 effectiveTpmThreshold 反映較早的更新)。封閉式 ConfigurableBillingStatus 的全關係 updateType 會繼續彙整專案中所有介面 (QPM、IndexingCore 和 Agent Search TPM) 的最新更新方向。

方法

get

 取得 Project。

patch

 更新 Discovery Engine 專案的可編輯設定。

provision

 佈建專案資源。

reportConsentChange

 更新這個專案的服務條款。