REST Resource: projects

Recurso: Project

Son los metadatos y la configuración de un proyecto de Google Cloud en el servicio.

Representación JSON 
{
  "name": string,
  "createTime": string,
  "provisionCompletionTime": string,
  "serviceTermsMap": {
    string: {
      object (ServiceTerms)
    },
    ...
  },
  "customerProvidedConfig": {
    object (CustomerProvidedConfig)
  },
  "configurableBillingStatus": {
    object (ConfigurableBillingStatus)
  }
}
Campos
name

string

Solo salida. Nombre completo del recurso del proyecto, por ejemplo, projects/{project}. Ten en cuenta que, cuando realices solicitudes, se aceptarán tanto el número como el ID del proyecto, pero el servidor siempre responderá con el número del proyecto.
createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la creación de este proyecto.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
provisionCompletionTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en la que se aprovisionó correctamente este proyecto. Un valor vacío significa que este proyecto aún se está aprovisionando y no está listo para usarse.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
serviceTermsMap

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

Solo salida. Es un mapa de las condiciones del servicio. La clave es el id de ServiceTerms.
customerProvidedConfig

object (CustomerProvidedConfig)

Es opcional. Son los parámetros de configuración proporcionados por el cliente.
configurableBillingStatus

object (ConfigurableBillingStatus)

Solo salida. Es el estado actual de la facturación configurable del proyecto.

ServiceTerms

Son los metadatos sobre las Condiciones del Servicio.

Representación JSON 
{
  "id": string,
  "version": string,
  "state": enum (State),
  "acceptTime": string,
  "declineTime": string
}
Campos
id

string

Es el identificador único de estas condiciones del servicio. Condiciones disponibles:
version

string

Es la cadena de versión de las condiciones del servicio. Para obtener valores aceptables, consulta los comentarios de id más arriba.
state

enum (State)

Indica si el proyecto aceptó o rechazó las condiciones del servicio, o si aún están pendientes.
acceptTime

string (Timestamp format)

Fecha y hora en que el proyecto aceptó las condiciones del servicio por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
declineTime

string (Timestamp format)

Fecha y hora en que el proyecto rechazó o revocó el acuerdo de las condiciones del servicio por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Estado

El acuerdo establece estas condiciones del servicio.

Enums
STATE_UNSPECIFIED Es el valor predeterminado de la enumeración. En realidad, este valor no se usa.
TERMS_ACCEPTED El proyecto dio su consentimiento a las condiciones del servicio.
TERMS_PENDING El proyecto está pendiente de revisión y aceptación de las condiciones del servicio.
TERMS_DECLINED El proyecto rechazó o revocó el acuerdo de las condiciones del servicio.

CustomerProvidedConfig

Son los parámetros de configuración proporcionados por el cliente.

Representación JSON 
{
  "notebooklmConfig": {
    object (NotebooklmConfig)
  }
}
Campos
notebooklmConfig

object (NotebooklmConfig)

Es opcional. Es la configuración de los parámetros de NotebookLM.

NotebooklmConfig

Es la configuración de NotebookLM.

Representación JSON 
{
  "modelArmorConfig": {
    object (ModelArmorConfig)
  },
  "optOutNotebookSharing": boolean,
  "dataProtectionPolicy": {
    object (DataProtectionPolicy)
  },
  "observabilityConfig": {
    object (ObservabilityConfig)
  }
}
Campos
modelArmorConfig

object (ModelArmorConfig)

Es la configuración de Model Armor que se usará para limpiar las instrucciones del usuario y las respuestas del LLM.
optOutNotebookSharing

boolean

Es opcional. Indica si se debe inhabilitar la función de uso compartido de notebooks para el proyecto. El valor predeterminado es falso si no se especifica.
dataProtectionPolicy

object (DataProtectionPolicy)

Es opcional. Especifica la política de protección de datos para NotebookLM.
observabilityConfig

object (ObservabilityConfig)

Es opcional. Es la configuración de observabilidad de NotebookLM.

ModelArmorConfig

Es la configuración de las plantillas de Model Armor definidas por el cliente que se usarán para limpiar las instrucciones del usuario y las respuestas del LLM.

Representación JSON 
{
  "userPromptTemplate": string,
  "responseTemplate": string
}
Campos
userPromptTemplate

string

Es opcional. Es el nombre del recurso de la plantilla de Model Armor para sanear las instrucciones del usuario. Formato: projects/{project}/locations/{location}/templates/{templateId}. Si no se especifica, no se aplicará ninguna limpieza a la instrucción del usuario.
responseTemplate

string

Es opcional. Es el nombre del recurso de la plantilla de Model Armor para limpiar las respuestas del LLM. Formato: projects/{project}/locations/{location}/templates/{templateId}. Si no se especifica, no se aplicará ninguna limpieza a la respuesta del LLM.

DataProtectionPolicy

Es la configuración de la política de protección de datos para NotebookLM.

Representación JSON 
{
  "sensitiveDataProtectionPolicy": {
    object (SensitiveDataProtectionPolicy)
  }
}
Campos
sensitiveDataProtectionPolicy

object (SensitiveDataProtectionPolicy)

Es opcional. Es la política de Sensitive Data Protection.

SensitiveDataProtectionPolicy

Especifica una política de Sensitive Data Protection (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview).

Representación JSON 
{
  "policy": string
}
Campos
policy

string

Es opcional. Es el nombre del recurso de la política de Sensitive Data Protection.

ConfigurableBillingStatus

Representa los parámetros de facturación configurables que se aplican actualmente. Estos valores se derivan del historial de suscripciones del cliente que se almacena de forma interna y reflejan los umbrales que se usan activamente para la facturación en el momento de la llamada a projects.get. Esto incluye la fecha y hora de inicio de la suscripción, y puede diferir de los valores en customerProvidedConfig debido a las reglas de facturación (p.ej., las reducciones de precios solo entran en vigencia al comienzo de un nuevo mes). También incluimos el tipo de actualización para indicar el tipo de actualización que se realizó en la configuración de facturación configurable en la operación projects.patch.

Representación JSON 
{
  "effectiveSearchQpmThreshold": string,
  "effectiveIndexingCoreThreshold": string,
  "startTime": string,
  "terminateTime": string,
  "searchQpmThresholdNextUpdateTime": string,
  "indexingCoreThresholdNextUpdateTime": string,
  "updateType": enum (UpdateType),
  "agentSearchTokenSubscriptionStatuses": [
    {
      object (AgentSearchTokenSubscriptionStatus)
    }
  ]
}
Campos
effectiveSearchQpmThreshold

string (int64 format)

Es opcional. Es el umbral de QPM de la Búsqueda que se aplica actualmente, expresado en búsquedas por minuto. Este es el umbral con el que se compara el uso de QPM para los cálculos de excedente.
effectiveIndexingCoreThreshold

string (int64 format)

Es opcional. Es el umbral actual y efectivo del núcleo de Indexación. Es el umbral con el que se compara el uso del núcleo de Indexación para los cálculos de excedentes.
startTime

string (Timestamp format)

Es opcional. Es la fecha y hora de inicio de la suscripción de facturación activa actualmente.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Solo salida. Es la fecha y hora de entrada en vigencia de la cancelación más reciente de las suscripciones principales de indexación y QPM de búsqueda.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
searchQpmThresholdNextUpdateTime

string (Timestamp format)

Solo salida. Es la próxima hora de actualización más temprana para el umbral de suscripción de QPM de la búsqueda. Esto se basa en el valor de next_update_time que devuelve la API de Cloud Billing Subscription V3 subyacente. Este campo solo se completa si se realiza correctamente una solicitud de actualización del umbral de suscripción al QPM.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
indexingCoreThresholdNextUpdateTime

string (Timestamp format)

Solo salida. Es la hora de la próxima actualización más próxima para el umbral de suscripción del núcleo de indexación. Esto se basa en el valor de next_update_time que devuelve la API de Cloud Billing Subscription V3 subyacente. Este campo solo se completa si se realiza correctamente una solicitud de umbral de suscripción principal de indexación de actualización.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Solo salida. Es el tipo de actualización que se realizó en esta operación. Este campo se propaga en la respuesta de projects.patch.
agentSearchTokenSubscriptionStatuses[]

object (AgentSearchTokenSubscriptionStatus)

Solo salida. Es el estado de suscripción al TPM de Agent Search por modelo.

UpdateType

Es el tipo de actualización que se realizó en la configuración de facturación configurable.

Enums
UPDATE_TYPE_UNSPECIFIED Tipo de actualización sin especificar.
CREATE Se creó o habilitó la facturación configurable.
DELETE Se borró o inhabilitó la facturación configurable.
SCALE_UP Se aumentó la escala de la suscripción (se incrementaron los umbrales).
SCALE_DOWN Se redujo la suscripción (disminuyeron los umbrales).

AgentSearchTokenSubscriptionStatus

Es el estado de suscripción al TPM de la Búsqueda con agente por modelo. Una entrada por cada entrada de coreSubscription.agent_search_token_subscriptions[*] activa en la configuración proporcionada por el cliente; se completa con projects.patch y projects.get.

Los valores escalares del ciclo de vida en este mensaje (startTime, terminateTime, updateType, tpmThresholdNextUpdateTime) son por (proyecto, modelVersion), es decir, son elementos secundarios de la relación completa startTime / terminateTime / updateType en el ConfigurableBillingStatus envolvente, pero se limitan a esta suscripción específica al TPM de Agent Search en lugar de a la relación general de precios configurables por el cliente. Esta granularidad por instancia es intencional: el almacenamiento subyacente de SubV3 es por (proyecto, modelVersion), por lo que cada modelo tiene su propio reloj de activación, finalización y actualización diferida. Mostrarlo en la respuesta les brinda a los clientes la granularidad que necesitan para administrar los compromisos por modelo de forma independiente. QPM y IndexingCore difieren: su almacenamiento es de una fila por (proyecto, ubicación), por lo que su ciclo de vida se representa solo con los escalares de relación completa en ConfigurableBillingStatus.

Representación JSON 
{
  "modelVersion": string,
  "effectiveTpmThreshold": string,
  "tpmThresholdNextUpdateTime": string,
  "startTime": string,
  "terminateTime": string,
  "updateType": enum (UpdateType)
}
Campos
modelVersion

string

Solo salida. Es la versión del modelo de Gemini a la que corresponde este estado. Coincide con CoreSubscription.AgentSearchTokenSubscription.model_version (una versión estable del modelo de Gemini del registro de versiones de modelos de Gemini Enterprise Agent Platform; consulta https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
effectiveTpmThreshold

string (int64 format)

Solo salida. Es el umbral de TPM vigente actualmente. Refleja el aumento de escala de inmediato y la reducción en el próximo ciclo de facturación, lo que coincide con la semántica de effectiveSearchQpmThreshold.
tpmThresholdNextUpdateTime

string (Timestamp format)

Solo salida. Es la fecha y hora de actualización más próxima para el umbral de suscripción al TPM de este par (proyecto, modelVersion). Se propaga solo después de una actualización exitosa.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

Solo salida. Fecha y hora en que se activó por primera vez esta suscripción al TPM de Agent Search (proyecto, modelVersion). Se establece una vez en la primera activación de esta versión del modelo y no se modifica con las actualizaciones posteriores del umbral. Cuando se finaliza y se vuelve a activar, se registra un valor nuevo. NO mueve el startTime de toda la relación en ConfigurableBillingStatus envolvente, que sigue representando la primera activación de la relación general de precios configurables por el cliente.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Solo salida. Si se configura, es la fecha y hora programadas en las que finalizará esta suscripción al TPM de Agent Search (proyecto, modelVersion). Se propaga cuando el cliente quita esta entrada de coreSubscription.agent_search_token_subscriptions[*]. NO mueve el terminateTime de toda la relación en ConfigurableBillingStatus envolvente, que se propaga solo cuando se desmantela toda la relación de precios configurables por el cliente.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Solo salida. Es el tipo de actualización más reciente de esta suscripción (project, modelVersion), según la llamada a projects.patch más reciente. UPDATE_TYPE_UNSPECIFIED indica que los proyectos.patch más recientes no modificaron este modelVersion (su effectiveTpmThreshold refleja una actualización anterior). La relación completa updateType en el ConfigurableBillingStatus envolvente sigue resumiendo la dirección de la actualización más reciente en todas las plataformas del proyecto (QPM, IndexingCore y Agent Search TPM en conjunto).

Métodos

get

 Obtienes una Project.

patch

 Actualiza la configuración editable de un proyecto de Discovery Engine.

provision

 Aprovisiona el recurso del proyecto.

reportConsentChange

 Actualiza las condiciones del servicio para este proyecto.