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)

출력 전용입니다. 이 프로젝트가 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
provisionCompletionTime

string (Timestamp format)

출력 전용입니다. 이 프로젝트가 성공적으로 프로비저닝된 시점의 타임스탬프입니다. 값이 비어 있으면 이 프로젝트가 아직 프로비저닝 중이며 사용할 준비가 되지 않았음을 의미합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

프로젝트가 서비스 약관에 동의한 마지막 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
declineTime

string (Timestamp format)

프로젝트에서 서비스 약관에 대한 동의를 거부하거나 취소한 마지막 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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

민감한 정보 보호 (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview) 정책을 지정합니다.

JSON 표현 
{
  "policy": string
}
필드
policy

string

선택사항입니다. 민감한 정보 보호 정책 리소스 이름입니다.

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)

선택사항. 현재 활성 상태인 결제 구독의 시작 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
terminateTime

string (Timestamp format)

출력 전용입니다. 검색 qpm 및 색인 생성 핵심 구독의 가장 최근 종료 유효 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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 구독 기준점 업데이트 요청이 성공한 경우에만 채워집니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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을 기반으로 합니다. 이 필드는 업데이트 색인 생성 핵심 구독 기준점 요청이 성공한 경우에만 채워집니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

출력 전용입니다. 모델별 에이전트 검색 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)별입니다. 전체 관계 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 model-versions registry의 안정적인 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 구독 기준의 가장 빠른 다음 업데이트 시간입니다. 업데이트가 성공한 후에만 채워집니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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로 이동하지 않습니다. 이는 계속해서 전체 고객 구성 가능 가격 책정 관계의 첫 번째 활성화를 나타냅니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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를 이동하지 않습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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

 이 프로젝트의 서비스 약관을 업데이트합니다.