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)
  },
  "resourceAccessControlConfig": {
    object (ResourceAccessControlConfig)
  }
}
欄位
notebooklmConfig

object (NotebooklmConfig)

選用。設定 NotebookLM。
resourceAccessControlConfig

object (ResourceAccessControlConfig)

選用。Gemini Enterprise 使用者的資源層級存取權控管設定。

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 政策資源名稱。

ResourceAccessControlConfig

控管 Gemini Enterprise 企業版使用者的資源層級存取控管。

JSON 表示法 
{
  "dataStoreAccessControlEnabled": boolean
}
欄位
dataStoreAccessControlEnabled

boolean

選用。如果 true，系統會篩選 Gemini Enterprise 企業版使用者可存取的資料儲存庫和資料連接器，只顯示使用者具備必要資源層級 .get IAM 權限的項目。

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

各模型 Agent Search 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)

僅供輸出。最近一次透過 projects.patch 呼叫對這個 (專案、modelVersion) 訂閱項目執行的更新類型。UPDATE_TYPE_UNSPECIFIED 表示這個 modelVersion 未受最近的 projects.patch 影響 (其 effectiveTpmThreshold 反映較早的更新)。整個關係 updateType 會繼續彙整封閉式 ConfigurableBillingStatus，總結專案中所有介面 (QPM、IndexingCore 和 Agent Search TPM) 的最新更新方向。

方法

get

 取得 Project。

patch

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

provision

 佈建專案資源。

reportConsentChange

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