REST Resource: projects

Ressource : Project

Métadonnées et configurations d'un projet Google Cloud dans le service.

Représentation JSON 
{
  "name": string,
  "createTime": string,
  "provisionCompletionTime": string,
  "serviceTermsMap": {
    string: {
      object (ServiceTerms)
    },
    ...
  },
  "customerProvidedConfig": {
    object (CustomerProvidedConfig)
  },
  "configurableBillingStatus": {
    object (ConfigurableBillingStatus)
  }
}
Champs
name

string

Uniquement en sortie. Nom complet de la ressource du projet, par exemple projects/{project}. Notez que le numéro et l'ID du projet sont tous deux acceptés lors de l'envoi de requêtes, mais que le serveur répondra toujours avec le numéro du projet.
createTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la création de ce projet.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
provisionCompletionTime

string (Timestamp format)

Uniquement en sortie. Code temporel indiquant la date à laquelle ce projet a été provisionné. Une valeur vide signifie que ce projet est toujours en cours de provisionnement et n'est pas prêt à être utilisé.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "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))

Uniquement en sortie. Carte des conditions d'utilisation. La clé est le id de ServiceTerms.
customerProvidedConfig

object (CustomerProvidedConfig)

Facultatif. Configurations fournies par le client.
configurableBillingStatus

object (ConfigurableBillingStatus)

Uniquement en sortie. État actuel de la facturation configurable du projet.

ServiceTerms

Métadonnées sur les conditions d'utilisation.

Représentation JSON 
{
  "id": string,
  "version": string,
  "state": enum (State),
  "acceptTime": string,
  "declineTime": string
}
Champs
id

string

Identifiant unique des présentes conditions d'utilisation. Termes disponibles :
version

string

Chaîne de version des conditions d'utilisation. Pour connaître les valeurs acceptables, consultez les commentaires de id ci-dessus.
state

enum (State)

Indique si le projet a accepté ou refusé les conditions d'utilisation du service, ou si la réponse est toujours en attente.
acceptTime

string (Timestamp format)

Date et heure auxquelles le projet a accepté les conditions d'utilisation pour la dernière fois.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
declineTime

string (Timestamp format)

Date et heure auxquelles le projet a refusé ou révoqué l'acceptation des conditions d'utilisation.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

État

L'accord stipule les présentes conditions d'utilisation.

Enums
STATE_UNSPECIFIED Valeur par défaut de l'énumération. Cette valeur n'est pas réellement utilisée.
TERMS_ACCEPTED Le projet a accepté les conditions d'utilisation.
TERMS_PENDING Le projet est en attente d'examen et d'acceptation des conditions d'utilisation.
TERMS_DECLINED Le projet a refusé ou révoqué l'acceptation des conditions d'utilisation.

CustomerProvidedConfig

Configurations fournies par le client.

Représentation JSON 
{
  "notebooklmConfig": {
    object (NotebooklmConfig)
  }
}
Champs
notebooklmConfig

object (NotebooklmConfig)

Facultatif. Configuration des paramètres NotebookLM.

NotebooklmConfig

Configuration pour NotebookLM.

Représentation JSON 
{
  "modelArmorConfig": {
    object (ModelArmorConfig)
  },
  "optOutNotebookSharing": boolean,
  "dataProtectionPolicy": {
    object (DataProtectionPolicy)
  },
  "observabilityConfig": {
    object (ObservabilityConfig)
  }
}
Champs
modelArmorConfig

object (ModelArmorConfig)

Configuration de Model Armor à utiliser pour assainir les requêtes utilisateur et les réponses du LLM.
optOutNotebookSharing

boolean

Facultatif. Indique s'il faut désactiver la fonctionnalité de partage de notebooks pour le projet. La valeur par défaut est "false" si aucune valeur n'est spécifiée.
dataProtectionPolicy

object (DataProtectionPolicy)

Facultatif. Spécifie la règle de protection des données pour NotebookLM.
observabilityConfig

object (ObservabilityConfig)

Facultatif. Configuration de l'observabilité pour NotebookLM.

ModelArmorConfig

Configuration des modèles Model Armor définis par le client à utiliser pour désinfecter les requêtes utilisateur et les réponses des LLM.

Représentation JSON 
{
  "userPromptTemplate": string,
  "responseTemplate": string
}
Champs
userPromptTemplate

string

Facultatif. Nom de ressource du modèle Model Armor pour assainir les requêtes utilisateur. Format : projects/{project}/locations/{location}/templates/{templateId}. Si ce champ n'est pas spécifié, aucune désinfection ne sera appliquée à la requête utilisateur.
responseTemplate

string

Facultatif. Nom de ressource du modèle Model Armor pour assainir les réponses des LLM. Format : projects/{project}/locations/{location}/templates/{templateId}. Si aucun format n'est spécifié, aucune désinfection ne sera appliquée à la réponse du LLM.

DataProtectionPolicy

Configuration de la règle de protection des données pour NotebookLM.

Représentation JSON 
{
  "sensitiveDataProtectionPolicy": {
    object (SensitiveDataProtectionPolicy)
  }
}
Champs
sensitiveDataProtectionPolicy

object (SensitiveDataProtectionPolicy)

Facultatif. La règle Sensitive Data Protection.

SensitiveDataProtectionPolicy

Spécifie une règle Sensitive Data Protection (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview).

Représentation JSON 
{
  "policy": string
}
Champs
policy

string

Facultatif. Nom de ressource de la règle Sensitive Data Protection.

ConfigurableBillingStatus

Représente les paramètres de facturation configurables actuellement en vigueur. Ces valeurs sont dérivées de l'historique des abonnements du client stocké en interne. Elles reflètent les seuils activement utilisés à des fins de facturation au moment de l'appel projects.get. Cela inclut la startTime de l'abonnement et peut différer des valeurs de customerProvidedConfig en raison des règles de facturation (par exemple, les réductions d'échelle ne prennent effet qu'au début d'un nouveau mois). Nous incluons également le type de mise à jour pour indiquer le type de mise à jour effectué sur la configuration de facturation configurable dans l'opération projects.patch.

Représentation JSON 
{
  "effectiveSearchQpmThreshold": string,
  "effectiveIndexingCoreThreshold": string,
  "startTime": string,
  "terminateTime": string,
  "searchQpmThresholdNextUpdateTime": string,
  "indexingCoreThresholdNextUpdateTime": string,
  "updateType": enum (UpdateType),
  "agentSearchTokenSubscriptionStatuses": [
    {
      object (AgentSearchTokenSubscriptionStatus)
    }
  ]
}
Champs
effectiveSearchQpmThreshold

string (int64 format)

Facultatif. Seuil de RPM (requêtes par minute) actuellement en vigueur pour la recherche. Il s'agit du seuil auquel l'utilisation des requêtes par minute est comparée pour calculer les dépassements.
effectiveIndexingCoreThreshold

string (int64 format)

Facultatif. Seuil actuel du cœur d'indexation. Il s'agit du seuil auquel l'utilisation d'Indexing Core est comparée pour calculer les dépassements.
startTime

string (Timestamp format)

Facultatif. Heure de début de l'abonnement de facturation actuellement actif.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Uniquement en sortie. Dernière heure de fin effective des abonnements aux requêtes par minute et à l'indexation du moteur de recherche.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
searchQpmThresholdNextUpdateTime

string (Timestamp format)

Uniquement en sortie. Heure de la prochaine mise à jour du seuil d'abonnement au RPM de recherche. Cette valeur est basée sur next_update_time renvoyé par l'API Cloud Billing Subscription V3 sous-jacente. Ce champ n'est renseigné que si une demande de mise à jour du seuil d'abonnement QPM a abouti.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
indexingCoreThresholdNextUpdateTime

string (Timestamp format)

Uniquement en sortie. Heure de la prochaine mise à jour la plus proche pour le seuil d'abonnement au service d'indexation. Cette valeur est basée sur next_update_time renvoyé par l'API Cloud Billing Subscription V3 sous-jacente. Ce champ n'est renseigné que si une demande de seuil d'abonnement au cœur d'indexation de mise à jour a abouti.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Uniquement en sortie. Type de mise à jour effectuée lors de cette opération. Ce champ est renseigné dans la réponse de projects.patch.
agentSearchTokenSubscriptionStatuses[]

object (AgentSearchTokenSubscriptionStatus)

Uniquement en sortie. État de l'abonnement TPM à la recherche d'agents par modèle.

UpdateType

Type de mise à jour effectuée sur la configuration de facturation configurable.

Enums
UPDATE_TYPE_UNSPECIFIED Type de mise à jour non spécifié.
CREATE La facturation configurable a été créée/activée.
DELETE La facturation configurable a été supprimée ou désactivée.
SCALE_UP L'abonnement a été étendu (les seuils ont été augmentés).
SCALE_DOWN L'abonnement a été rétrogradé (les seuils ont diminué).

AgentSearchTokenSubscriptionStatus

État de l'abonnement TPM à la recherche d'agents par modèle. Une entrée par entrée coreSubscription.agent_search_token_subscriptions[*] active dans la configuration fournie par le client. Elle est renseignée par projects.patch et projects.get.

Les scalaires de cycle de vie de ce message (startTime, terminateTime, updateType, tpmThresholdNextUpdateTime) sont par (projet, modelVersion) : ils sont au même niveau que les startTime / terminateTime / updateType de la relation globale sur le ConfigurableBillingStatus englobant, mais sont limités à cet abonnement TPM Agent Search spécifique au lieu de l'ensemble de la relation de tarification configurable par le client. Cette granularité par instance est intentionnelle : le stockage SubV3 sous-jacent est par (projet, modelVersion). Chaque modèle possède donc sa propre horloge d'activation, de résiliation et de mise à jour différée. L'affichage de cette information dans la réponse offre aux clients la granularité dont ils ont besoin pour gérer les engagements par modèle de manière indépendante. QPM / IndexingCore diffèrent : leur stockage est d'une ligne par (projet, emplacement). Leur cycle de vie n'est donc représenté que par les scalaires de relation entière sur ConfigurableBillingStatus.

Représentation JSON 
{
  "modelVersion": string,
  "effectiveTpmThreshold": string,
  "tpmThresholdNextUpdateTime": string,
  "startTime": string,
  "terminateTime": string,
  "updateType": enum (UpdateType)
}
Champs
modelVersion

string

Uniquement en sortie. Version du modèle Gemini à laquelle correspond cet état. Correspond à CoreSubscription.AgentSearchTokenSubscription.model_version (une version stable du modèle Gemini du registre des versions de modèle Gemini Enterprise Agent Platform ; consultez https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
effectiveTpmThreshold

string (int64 format)

Uniquement en sortie. Seuil de TPM actuellement en vigueur. Reflète immédiatement l'augmentation de l'échelle et la diminution de l'échelle lors du prochain cycle de facturation, conformément à la sémantique de effectiveSearchQpmThreshold.
tpmThresholdNextUpdateTime

string (Timestamp format)

Uniquement en sortie. Heure de la prochaine mise à jour la plus proche pour le seuil d'abonnement TPM pour cette paire (projet, modelVersion). Valeur renseignée uniquement après une mise à jour réussie.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

Uniquement en sortie. Date à laquelle cet abonnement TPM (projet, modelVersion) Agent Search a été activé pour la première fois. Définie une seule fois lors de la première activation de cette version du modèle et jamais modifiée par les mises à jour ultérieures du seuil. Une nouvelle valeur est enregistrée en cas de résiliation et de réactivation. Ne déplace PAS l'intégralité de la startTime de la relation sur l'objet ConfigurableBillingStatus englobant, qui continue de représenter la première activation de la relation globale de tarification configurable par le client.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Uniquement en sortie. Si elle est définie, il s'agit de l'heure d'entrée en vigueur planifiée à laquelle cet abonnement TPM Agent Search (projet, modelVersion) prendra fin. Renseigné lorsque le client supprime cette entrée de coreSubscription.agent_search_token_subscriptions[*]. Ne déplace PAS l'intégralité de la relation terminateTime sur l'élément ConfigurableBillingStatus englobant, qui n'est renseigné que lorsque l'intégralité de la relation de tarification configurable par le client est supprimée.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Uniquement en sortie. Type de la mise à jour la plus récente de cet abonnement (project, modelVersion), tel qu'effectué par le dernier appel projects.patch. UPDATE_TYPE_UNSPECIFIED indique que cette modelVersion n'a pas été modifiée par le dernier patch de projet (son effectiveTpmThreshold reflète une mise à jour antérieure). La relation updateType globale sur l'élément ConfigurableBillingStatus englobant continue de résumer l'orientation de la mise à jour la plus récente sur toutes les surfaces du projet (QPM, IndexingCore et Agent Search TPM ensemble).

Méthodes

get

 Récupère un Project.

patch

 Met à jour les paramètres modifiables d'un projet Discovery Engine.

provision

 Provisionne la ressource de projet.

reportConsentChange

 Met à jour les conditions d'utilisation du service pour ce projet.