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 do 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 declara 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 consentiu com os Termos de Serviço.
TERMS_PENDING O projeto está pendente para 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)
  },
  "resourceAccessControlConfig": {
    object (ResourceAccessControlConfig)
  }
}
Campos
notebooklmConfig

object (NotebooklmConfig)

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

object (ResourceAccessControlConfig)

Opcional. Configuração de controle de acesso no nível do recurso para usuários corporativos do Gemini Enterprise.

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 limpar comandos do usuário e respostas do LLM.
optOutNotebookSharing

boolean

Opcional. 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 com definições personalizadas a serem usados para limpar 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 limpar 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 higienização de respostas do LLM. 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 do 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.

ResourceAccessControlConfig

Controla o controle de acesso no nível de recurso para usuários corporativos do Gemini Enterprise.

Representação JSON 
{
  "dataStoreAccessControlEnabled": boolean
}
Campos
dataStoreAccessControlEnabled

boolean

Opcional. Se true, os repositórios de dados e conectores de dados mostrados aos usuários corporativos do Gemini Enterprise serão filtrados para aqueles em que o usuário tem a permissão .get do IAM no nível do recurso.

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 efetivo de encerramento 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 do limite de 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 horário da próxima atualização mais antiga para o limite de assinatura principal da 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 Google por 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 Google por 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 do startTime / terminateTime / updateType de relacionamento completo no ConfigurableBillingStatus envolvente, mas com escopo para esta assinatura específica do TPM da Pesquisa do agente em vez do relacionamento geral de preços configuráveis pelo cliente. Essa granularidade por instância é intencional: o armazenamento SubV3 subjacente é por (projeto, modelVersion), então cada modelo tem seu próprio relógio de ativação, encerramento e 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 são diferentes: o armazenamento deles é uma linha por (projeto, local), então o ciclo de vida é representado apenas pelos escalares de relacionamento inteiro em 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 "model-versions" 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 aumento imediatamente e a redução 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 (projeto, modelVersion). Preenchido apenas 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. No encerramento e na 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 inteiro 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 Agent Search TPM 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.