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 de 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 et l'heure auxquelles 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. Conditions 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 demande est toujours en attente.
acceptTime

string (Timestamp format)

Date et heure de la dernière acceptation des conditions d'utilisation par le 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".
declineTime

string (Timestamp format)

Date et heure auxquelles le projet a refusé ou révoqué les 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 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)
  },
  "resourceAccessControlConfig": {
    object (ResourceAccessControlConfig)
  }
}
Champs
notebooklmConfig

object (NotebooklmConfig)

Facultatif. Configuration des paramètres NotebookLM.
resourceAccessControlConfig

object (ResourceAccessControlConfig)

Facultatif. Configuration du contrôle des accès au niveau des ressources pour les utilisateurs de la version Enterprise de Gemini.

NotebooklmConfig

Configuration pour NotebookLM.

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

object (ModelArmorConfig)

Configuration Model Armor à utiliser pour nettoyer 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. Si aucune valeur n'est spécifiée, la valeur par défaut est "false".
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 nettoyer 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 nettoyer les requêtes utilisateur. Format : projects/{project}/locations/{location}/templates/{templateId}. Si aucun modèle n'est 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 aucune valeur n'est spécifiée, 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.

ResourceAccessControlConfig

Contrôle l'accès aux ressources pour les utilisateurs Gemini Enterprise.

Représentation JSON 
{
  "dataStoreAccessControlEnabled": boolean
}
Champs
dataStoreAccessControlEnabled

boolean

Facultatif. Si la valeur est true, les datastores et les connecteurs de données affichés aux utilisateurs de Gemini Enterprise sont filtrés pour n'inclure que ceux pour lesquels l'utilisateur dispose de l'autorisation IAM .get requise au niveau de la ressource.

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 le 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 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 RPM pour la recherche. Cette date est basée sur la valeur next_update_time renvoyée 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 au 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 cœur d'indexation. Cette date est basée sur la valeur next_update_time renvoyée 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 au moteur d'indexation 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éduit (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 associés à chaque (projet, modelVersion). Ils sont frères des startTime / terminateTime / updateType de la relation globale sur l'objet 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 précision 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 ces informations dans la réponse permet aux clients de bénéficier de la précision dont ils ont besoin pour gérer les engagements par modèle de manière indépendante. QPM / IndexingCore sont différents : leur stockage est 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 ; voir https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
effectiveTpmThreshold

string (int64 format)

Uniquement en sortie. Seuil TPM actuellement en vigueur. La mise à l'échelle est reflétée immédiatement pour l'augmentation et lors du prochain cycle de facturation pour la diminution, ce qui correspond à 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 ConfigurableBillingStatus englobante, 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 effective 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 (projet, 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 projects.patch (son effectiveTpmThreshold reflète une mise à jour antérieure). La relation globale updateType 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.