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

この利用規約の固有識別子。利用可能なキーワード:
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

ユーザー プロンプトと LLM レスポンスのサニタイズに使用される、お客様が定義した Model Armor テンプレートの構成。

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

現在有効になっていて構成可能な課金パラメータを表します。これらの値は、内部に保存されている顧客のサブスクリプション履歴から取得され、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 しきい値（1 分あたりのクエリ数）。これは、超過料金の計算で 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[*] エントリごとに 1 つのエントリ。projects.patch と projects.get によって入力されます。

このメッセージのライフサイクル スカラー（startTime、terminateTime、updateType、tpmThresholdNextUpdateTime）は（プロジェクト、modelVersion）ごとです。これらは、外側の ConfigurableBillingStatus の全体関係 startTime / terminateTime / updateType の兄弟ですが、顧客が構成可能な価格設定の関係全体ではなく、この特定の Agent Search TPM サブスクリプションにスコープ設定されています。このインスタンス単位の粒度は意図的なものです。基盤となる SubV3 ストレージは（プロジェクト、modelVersion）単位であるため、各モデルには独自の有効化、終了、遅延更新クロックがあります。レスポンスでこれを公開することで、顧客はモデルごとのコミットメントを個別に管理するために必要な粒度を得ることができます。QPM / IndexingCore は異なります。ストレージは（プロジェクト、ロケーション）ごとに 1 行であるため、ライフサイクルは 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）エージェント検索 TPM サブスクリプションが最初に有効になった日時。このモデル バージョンの初回有効化時に 1 回設定され、以降のしきい値の更新で移動することはありません。終了して再有効化すると、新しい値が記録されます。囲み 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 の whole-relationship 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 は以前の更新を反映しています）。囲み ConfigurableBillingStatus の全関係 updateType は、プロジェクト内のすべてのサーフェス（QPM、IndexingCore、Agent Search TPM を合わせたもの）における最新の更新の方向性を引き続き要約します。

メソッド

get

 Project を取得します。

patch

 Discovery Engine プロジェクトの編集可能な設定を更新します。

provision

 プロジェクト リソースをプロビジョニングします。

reportConsentChange

 このプロジェクトのサービス規約を更新します。