REST Resource: projects

Recurso: Project

Metadados e configurações de um projeto do Google Cloud no serviço.

Representação JSON 
{
  "name": string,
  "createTime": string,
  "provisionCompletionTime": string,
  "serviceTermsMap": {
    string: {
      object (ServiceTerms)
    },
    ...
  },
  "customerProvidedConfig": {
    object (CustomerProvidedConfig)
  },
  "configurableBillingStatus": {
    object (ConfigurableBillingStatus)
  }
}
Campos
name

string

Apenas saída. Nome completo do recurso do projeto, por exemplo, projects/{project}. Ao fazer solicitações, o número e o ID do projeto são aceitáveis, mas o servidor sempre responde com o número do projeto.
createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o projeto foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
provisionCompletionTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o projeto foi provisionado. Um valor vazio significa que o projeto ainda está sendo provisionado e não está pronto para uso.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
serviceTermsMap

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

Apenas saída. Um mapa de Termos de Serviço. A chave é o id de ServiceTerms.
customerProvidedConfig

object (CustomerProvidedConfig)

Opcional. Configurações fornecidas pelo cliente.
configurableBillingStatus

object (ConfigurableBillingStatus)

Apenas saída. O status atual do faturamento configurável do projeto.

ServiceTerms

Metadados sobre os Termos de Serviço.

Representação JSON 
{
  "id": string,
  "version": string,
  "state": enum (State),
  "acceptTime": string,
  "declineTime": string
}
Campos
id

string

O identificador exclusivo destes Termos de Serviço. Termos disponíveis:
version

string

A string da versão dos Termos de Serviço. Para valores aceitáveis, consulte os comentários de id acima.
state

enum (State)

Se o projeto aceitou/rejeitou os termos de serviço ou se ainda está pendente.
acceptTime

string (Timestamp format)

A última vez em que o projeto concordou com os Termos de Serviço.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
declineTime

string (Timestamp format)

A última vez em que o projeto recusou ou revogou o contrato de termos de serviço.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Estado

O contrato afirma estes Termos de Serviço.

Tipos enumerados
STATE_UNSPECIFIED O valor padrão da enumeração. Esse valor não é usado.
TERMS_ACCEPTED O projeto deu consentimento aos Termos de Serviço.
TERMS_PENDING O projeto está pendente de revisão e aceitação dos Termos de Serviço.
TERMS_DECLINED O projeto recusou ou revogou o contrato de termos de serviço.

CustomerProvidedConfig

Configurações fornecidas pelo cliente.

Representação JSON 
{
  "notebooklmConfig": {
    object (NotebooklmConfig)
  }
}
Campos
notebooklmConfig

object (NotebooklmConfig)

Opcional. Configuração das configurações do NotebookLM.

NotebooklmConfig

Configuração do NotebookLM.

Representação JSON 
{
  "modelArmorConfig": {
    object (ModelArmorConfig)
  },
  "optOutNotebookSharing": boolean,
  "dataProtectionPolicy": {
    object (DataProtectionPolicy)
  },
  "observabilityConfig": {
    object (ObservabilityConfig)
  }
}
Campos
modelArmorConfig

object (ModelArmorConfig)

Configuração do Model Armor a ser usada para higienizar comandos do usuário e respostas do LLM.
optOutNotebookSharing

boolean

Opcional. Indica se o recurso de compartilhamento de notebooks será desativado para o projeto. O padrão é "false" se não for especificado.
dataProtectionPolicy

object (DataProtectionPolicy)

Opcional. Especifica a política de proteção de dados do NotebookLM.
observabilityConfig

object (ObservabilityConfig)

Opcional. Configuração de observabilidade para o NotebookLM.

ModelArmorConfig

Configuração para modelos do Model Armor definidos pelo cliente que serão usados para higienizar comandos do usuário e respostas do LLM.

Representação JSON 
{
  "userPromptTemplate": string,
  "responseTemplate": string
}
Campos
userPromptTemplate

string

Opcional. O nome do recurso do modelo do Model Armor para higienização de comandos do usuário. Formato: projects/{project}/locations/{location}/templates/{templateId}. Se não for especificado, nenhuma limpeza será aplicada ao comando do usuário.
responseTemplate

string

Opcional. O nome do recurso do modelo do Model Armor para higienizar respostas de LLMs. Formato: projects/{project}/locations/{location}/templates/{templateId}. Se não for especificado, nenhuma limpeza será aplicada à resposta do LLM.

DataProtectionPolicy

configuração da política de proteção de dados para o NotebookLM.

Representação JSON 
{
  "sensitiveDataProtectionPolicy": {
    object (SensitiveDataProtectionPolicy)
  }
}
Campos
sensitiveDataProtectionPolicy

object (SensitiveDataProtectionPolicy)

Opcional. A política de proteção de dados sensíveis.

SensitiveDataProtectionPolicy

Especifica uma política de Proteção de Dados Sensíveis (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview).

Representação JSON 
{
  "policy": string
}
Campos
policy

string

Opcional. O nome do recurso da política de proteção de dados sensíveis.

ConfigurableBillingStatus

Representa os parâmetros de faturamento configuráveis atualmente em vigor. Esses valores são derivados do histórico de assinaturas do cliente armazenado internamente e refletem os limites usados ativamente para fins de faturamento no momento da chamada "projects.get". Isso inclui o startTime da assinatura e pode ser diferente dos valores em customerProvidedConfig devido às regras de faturamento (por exemplo, reduções de escala que entram em vigor apenas no início de um novo mês). Também incluímos o tipo de atualização para indicar o tipo de atualização realizada na configuração de faturamento configurável na operação "projects.patch".

Representação JSON 
{
  "effectiveSearchQpmThreshold": string,
  "effectiveIndexingCoreThreshold": string,
  "startTime": string,
  "terminateTime": string,
  "searchQpmThresholdNextUpdateTime": string,
  "indexingCoreThresholdNextUpdateTime": string,
  "updateType": enum (UpdateType),
  "agentSearchTokenSubscriptionStatuses": [
    {
      object (AgentSearchTokenSubscriptionStatus)
    }
  ]
}
Campos
effectiveSearchQpmThreshold

string (int64 format)

Opcional. O limite de QPM da Pesquisa atualmente em vigor em consultas por minuto. Esse é o limite em relação ao qual o uso de QPM é comparado para cálculos de excedente.
effectiveIndexingCoreThreshold

string (int64 format)

Opcional. O limite atual do Indexing Core. Esse é o limite em relação ao qual o uso do Indexing Core é comparado para cálculos de excedente.
startTime

string (Timestamp format)

Opcional. O horário de início da assinatura de faturamento ativa no momento.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Apenas saída. O último horário de término efetivo das assinaturas principais de QPM de pesquisa e indexação.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
searchQpmThresholdNextUpdateTime

string (Timestamp format)

Apenas saída. O primeiro horário da próxima atualização para o limite da assinatura de QPM de pesquisa. Isso se baseia no next_update_time retornado pela API Cloud Billing Subscription V3 subjacente. Esse campo só é preenchido se uma solicitação de atualização do limite de assinatura de QPM for bem-sucedida.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
indexingCoreThresholdNextUpdateTime

string (Timestamp format)

Apenas saída. O primeiro horário da próxima atualização para o limite de assinatura principal de indexação. Isso se baseia no next_update_time retornado pela API Cloud Billing Subscription V3 subjacente. Esse campo só é preenchido se uma solicitação de atualização do limite de assinatura principal de indexação for bem-sucedida.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Apenas saída. O tipo de atualização realizada nesta operação. Esse campo é preenchido na resposta de "projects.patch".
agentSearchTokenSubscriptionStatuses[]

object (AgentSearchTokenSubscriptionStatus)

Apenas saída. Status da assinatura de TPM da Pesquisa do agente por modelo.

UpdateType

O tipo de atualização realizada na configuração de faturamento configurável.

Tipos enumerados
UPDATE_TYPE_UNSPECIFIED Tipo de atualização não especificado.
CREATE O faturamento configurável foi criado/ativado.
DELETE O faturamento configurável foi excluído/desativado.
SCALE_UP A assinatura foi ampliada (aumentos nos limites).
SCALE_DOWN A assinatura foi reduzida (os limites diminuíram).

AgentSearchTokenSubscriptionStatus

Status da assinatura de TPM da Pesquisa do agente por modelo. Uma entrada por entrada coreSubscription.agent_search_token_subscriptions[*] ativa na configuração fornecida pelo cliente, preenchida por "projects.patch" e "projects.get".

Os escalares de ciclo de vida nesta mensagem (startTime, terminateTime, updateType, tpmThresholdNextUpdateTime) são por (projeto, modelVersion), irmãos da relação completa startTime / terminateTime / updateType no ConfigurableBillingStatus envolvente, mas com escopo para esta assinatura específica do TPM da Pesquisa do agente, em vez da relação geral de preços configuráveis pelo cliente. Essa granularidade por instância é intencional: o armazenamento SubV3 subjacente é por (projeto, modelVersion). Portanto, cada modelo tem sua própria ativação, encerramento e relógio de atualização adiada. Ao mostrar isso na resposta, os clientes têm a granularidade necessária para gerenciar compromissos por modelo de forma independente. QPM / IndexingCore differ — their storage is one row per (project, location), so their lifecycle is represented only by the whole- relationship scalars on ConfigurableBillingStatus.

Representação JSON 
{
  "modelVersion": string,
  "effectiveTpmThreshold": string,
  "tpmThresholdNextUpdateTime": string,
  "startTime": string,
  "terminateTime": string,
  "updateType": enum (UpdateType)
}
Campos
modelVersion

string

Apenas saída. A versão do modelo do Gemini a que este status corresponde. Corresponde a "CoreSubscription.AgentSearchTokenSubscription.model_version", uma versão estável do modelo do Gemini do registro de versões de modelo da Gemini Enterprise Agent Platform. Consulte https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
effectiveTpmThreshold

string (int64 format)

Apenas saída. O limite de TPM atualmente em vigor. Reflete o escalonamento vertical imediatamente e o escalonamento horizontal no próximo ciclo de faturamento, correspondendo à semântica effectiveSearchQpmThreshold.
tpmThresholdNextUpdateTime

string (Timestamp format)

Apenas saída. O primeiro horário da próxima atualização do limite de assinatura do TPM para este (project, modelVersion). Preenchido somente após uma atualização bem-sucedida.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

Apenas saída. Quando esta assinatura de TPM da Pesquisa do agente (projeto, modelVersion) foi ativada pela primeira vez. Definido uma vez na primeira ativação desta versão do modelo e nunca movido por atualizações subsequentes de limite. Na rescisão e reativação, um novo valor é registrado. NÃO move o startTime de relacionamento completo no ConfigurableBillingStatus envolvente, que continua representando a primeira ativação do relacionamento geral de preços configuráveis pelo cliente.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Apenas saída. Se definido, o horário efetivo programado em que esta assinatura de TPM da Pesquisa do agente (projeto, modelVersion) será encerrada. Preenchido quando o cliente remove essa entrada de coreSubscription.agent_search_token_subscriptions[*]. NÃO move o terminateTime de relacionamento completo no ConfigurableBillingStatus envolvente, que é preenchido apenas quando toda a relação de preços configuráveis pelo cliente está sendo desfeita.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Apenas saída. O tipo da atualização mais recente desta assinatura (project, modelVersion), conforme realizado pela chamada projects.patch mais recente. UPDATE_TYPE_UNSPECIFIED indica que essa modelVersion não foi afetada pelo projects.patch mais recente. O effectiveTpmThreshold dela reflete uma atualização anterior. O updateType de relacionamento completo no ConfigurableBillingStatus envolvente continua resumindo a direção da atualização mais recente em todas as plataformas do projeto (QPM, IndexingCore e TPM da pesquisa do agente juntos).

Métodos

get

 Recebe um Project.

patch

 Atualiza as configurações editáveis de um projeto do Discovery Engine.

provision

 Provisiona o recurso do projeto.

reportConsentChange

 Atualiza os termos de serviço deste projeto.