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 que proporciona el cliente.
configurableBillingStatus

object (ConfigurableBillingStatus)

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

ServiceTerms

Son 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.

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. Este valor no se usa en realidad.
TERMS_ACCEPTED El proyecto otorgó 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 que proporciona el cliente.

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

object (NotebooklmConfig)

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

object (ResourceAccessControlConfig)

Es opcional. Es la configuración del control de acceso a nivel de recursos para los usuarios empresariales de Gemini Enterprise.

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 sanear 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. Si no se especifica, el valor predeterminado es falso.
dataProtectionPolicy

object (DataProtectionPolicy)

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

object (ObservabilityConfig)

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

ModelArmorConfig

Configuración de las plantillas de Model Armor de definición personalizada 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 limpiar 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 de 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.

ResourceAccessControlConfig

Controla el acceso a nivel de recursos para los usuarios de Gemini Enterprise.

Representación JSON 
{
  "dataStoreAccessControlEnabled": boolean
}
Campos
dataStoreAccessControlEnabled

boolean

Es opcional. Si es true, los almacenes de datos y los conectores de datos que se muestran a los usuarios empresariales de Gemini Enterprise se filtran para incluir solo aquellos en los que el usuario tiene el permiso de IAM .get a nivel del recurso requerido.

ConfigurableBillingStatus

Representa los parámetros de facturación configurables vigentes 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 fines de facturación en el momento de la llamada a projects.get. Esto incluye el startTime de la suscripción y puede diferir de los valores en customerProvidedConfig debido a las reglas de facturación (p.ej., las reducciones de escala 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 excedentes.
effectiveIndexingCoreThreshold

string (int64 format)

Es opcional. Es el umbral actual y efectivo del núcleo de indexación. Este es el umbral con el que se compara el uso de Indexing Core 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 la 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 muestra la API de Facturación de Cloud 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 cercana para el umbral de suscripción del núcleo de indexación. Esto se basa en el valor de next_update_time que muestra la API de Facturación de Cloud Subscription V3 subyacente. Este campo solo se completa si se realiza correctamente una solicitud de actualización del umbral de suscripción del núcleo de indexació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 la Búsqueda con agente por modelo.

UpdateType

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

Enums
UPDATE_TYPE_UNSPECIFIED No se especificó el tipo de actualización.
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 (project, modelVersion), es decir, elementos secundarios de los valores startTime / terminateTime / updateType de la relación completa 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 que puede configurar 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 / IndexingCore difieren: su almacenamiento es de una fila por (proyecto, ubicación), por lo que su ciclo de vida solo se representa 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 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 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 próxima fecha y hora de actualización más temprana para el umbral de suscripción del 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 la Búsqueda con IA (proyecto, versión del modelo). Se establece una vez en la primera activación de esta versión del modelo y nunca 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, versión del modelo). Se propaga cuando el cliente quita esta entrada de coreSubscription.agent_search_token_subscriptions[*]. NO mueve el terminateTime de toda la relación en el ConfigurableBillingStatus envolvente, que se completa 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 este modelVersion no se modificó con el projects.patch más reciente (su effectiveTpmThreshold refleja una actualización anterior). El updateType de relación completa 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 TPM de Agent Search 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.