REST Resource: projects

Risorsa: Project

Metadati e configurazioni per un progetto Google Cloud nel servizio.

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "provisionCompletionTime": string,
  "serviceTermsMap": {
    string: {
      object (ServiceTerms)
    },
    ...
  },
  "customerProvidedConfig": {
    object (CustomerProvidedConfig)
  },
  "configurableBillingStatus": {
    object (ConfigurableBillingStatus)
  }
}
Campi
name

string

Solo output. Nome completo della risorsa del progetto, ad esempio projects/{project}. Tieni presente che, quando effettui richieste, sono accettabili sia il numero di progetto sia l'ID progetto, ma il server risponderà sempre con il numero di progetto.
createTime

string (Timestamp format)

Solo output. Il timestamp di creazione del progetto.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
provisionCompletionTime

string (Timestamp format)

Solo output. Il timestamp di provisioning del progetto. Un valore vuoto indica che il progetto è ancora in fase di provisioning e non è pronto per l'uso.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "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 output. Una mappa dei termini di servizio. La chiave è id di ServiceTerms.
customerProvidedConfig

object (CustomerProvidedConfig)

Facoltativo. Configurazioni fornite dal cliente.
configurableBillingStatus

object (ConfigurableBillingStatus)

Solo output. Lo stato attuale della fatturazione configurabile del progetto.

ServiceTerms

Metadati relativi ai Termini di servizio.

Rappresentazione JSON 
{
  "id": string,
  "version": string,
  "state": enum (State),
  "acceptTime": string,
  "declineTime": string
}
Campi
id

string

L'identificatore univoco di questi Termini di servizio. Termini disponibili:
version

string

La stringa della versione dei Termini di servizio. Per i valori accettabili, vedi i commenti per id sopra.
state

enum (State)

Indica se il progetto ha accettato/rifiutato i termini di servizio o se l'accettazione è ancora in attesa.
acceptTime

string (Timestamp format)

L'ultima volta in cui il progetto ha accettato i Termini di servizio.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
declineTime

string (Timestamp format)

L'ultima volta in cui il progetto ha rifiutato o revocato l'accettazione dei Termini di servizio.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Stato

Il contratto stabilisce questi Termini di servizio.

Enum
STATE_UNSPECIFIED Il valore predefinito dell'enum. Questo valore non viene effettivamente utilizzato.
TERMS_ACCEPTED Il progetto ha dato il consenso ai Termini di servizio.
TERMS_PENDING Il progetto è in attesa di revisione e accettazione dei Termini di servizio.
TERMS_DECLINED Il progetto ha rifiutato o revocato l'accettazione dei Termini di servizio.

CustomerProvidedConfig

Configurazioni fornite dal cliente.

Rappresentazione JSON 
{
  "notebooklmConfig": {
    object (NotebooklmConfig)
  }
}
Campi
notebooklmConfig

object (NotebooklmConfig)

Facoltativo. Configurazione per le impostazioni di NotebookLM.

NotebooklmConfig

Configurazione per NotebookLM.

Rappresentazione JSON 
{
  "modelArmorConfig": {
    object (ModelArmorConfig)
  },
  "optOutNotebookSharing": boolean,
  "dataProtectionPolicy": {
    object (DataProtectionPolicy)
  },
  "observabilityConfig": {
    object (ObservabilityConfig)
  }
}
Campi
modelArmorConfig

object (ModelArmorConfig)

Configurazione di Model Armor da utilizzare per la sanitizzazione dei prompt degli utenti e delle risposte LLM.
optOutNotebookSharing

boolean

Facoltativo. Indica se disattivare la funzionalità di condivisione dei notebook per il progetto. Se non specificato, il valore predefinito è false.
dataProtectionPolicy

object (DataProtectionPolicy)

Facoltativo. Specifica la policy di protezione dei dati per NotebookLM.
observabilityConfig

object (ObservabilityConfig)

Facoltativo. Configurazione di osservabilità per NotebookLM.

ModelArmorConfig

Configurazione dei modelli Model Armor definiti dal cliente da utilizzare per la sanitizzazione dei prompt degli utenti e delle risposte LLM.

Rappresentazione JSON 
{
  "userPromptTemplate": string,
  "responseTemplate": string
}
Campi
userPromptTemplate

string

Facoltativo. Il nome risorsa del template Model Armor per la sanificazione dei prompt dell'utente. Formato: projects/{project}/locations/{location}/templates/{templateId}. Se non specificato, non verrà applicata alcuna sanificazione al prompt dell'utente.
responseTemplate

string

Facoltativo. Il nome della risorsa del modello Model Armor per la sanitizzazione delle risposte LLM. Formato: projects/{project}/locations/{location}/templates/{templateId}. Se non specificato, alla risposta del modello LLM non verrà applicata alcuna sanificazione.

DataProtectionPolicy

configurazione della policy di protezione dei dati per NotebookLM.

Rappresentazione JSON 
{
  "sensitiveDataProtectionPolicy": {
    object (SensitiveDataProtectionPolicy)
  }
}
Campi
sensitiveDataProtectionPolicy

object (SensitiveDataProtectionPolicy)

Facoltativo. La policy di protezione dei dati sensibili.

SensitiveDataProtectionPolicy

Specifica una policy di Sensitive Data Protection (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview).

Rappresentazione JSON 
{
  "policy": string
}
Campi
policy

string

Facoltativo. Il nome della risorsa della policy Sensitive Data Protection.

ConfigurableBillingStatus

Rappresenta i parametri di fatturazione configurabili attualmente in vigore. Questi valori derivano dalla cronologia degli abbonamenti del cliente archiviata internamente e riflettono le soglie utilizzate attivamente a fini di fatturazione al momento della chiamata projects.get. Ciò include lo startTime dell'abbonamento e potrebbe differire dai valori in customerProvidedConfig a causa delle regole di fatturazione (ad esempio, le riduzioni di scala che entrano in vigore solo all'inizio di un nuovo mese). Includiamo anche il tipo di aggiornamento per indicare il tipo di aggiornamento eseguito sulla configurazione di fatturazione configurabile nell'operazione projects.patch.

Rappresentazione JSON 
{
  "effectiveSearchQpmThreshold": string,
  "effectiveIndexingCoreThreshold": string,
  "startTime": string,
  "terminateTime": string,
  "searchQpmThresholdNextUpdateTime": string,
  "indexingCoreThresholdNextUpdateTime": string,
  "updateType": enum (UpdateType),
  "agentSearchTokenSubscriptionStatuses": [
    {
      object (AgentSearchTokenSubscriptionStatus)
    }
  ]
}
Campi
effectiveSearchQpmThreshold

string (int64 format)

Facoltativo. La soglia QPM di ricerca attualmente effettiva in query al minuto. Questa è la soglia rispetto alla quale viene confrontato l'utilizzo di QPM per i calcoli del superamento.
effectiveIndexingCoreThreshold

string (int64 format)

Facoltativo. La soglia di Indexing Core attualmente in vigore. Questa è la soglia rispetto alla quale viene confrontato l'utilizzo di Indexing Core per i calcoli dell'eccedenza.
startTime

string (Timestamp format)

Facoltativo. L'ora di inizio dell'abbonamento di fatturazione attualmente attivo.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Solo output. L'ultima ora effettiva di chiusura delle query al minuto di ricerca e degli abbonamenti di indicizzazione di base.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
searchQpmThresholdNextUpdateTime

string (Timestamp format)

Solo output. La prima ora di aggiornamento successiva per la soglia di abbonamento QPM per la ricerca. Questo valore si basa su next_update_time restituito dall'API Cloud Billing Subscription V3 sottostante. Questo campo viene compilato solo se una richiesta di soglia di abbonamento QPM aggiornata è andata a buon fine.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
indexingCoreThresholdNextUpdateTime

string (Timestamp format)

Solo output. La prima ora del prossimo aggiornamento per la soglia di abbonamento del core di indicizzazione. Questo valore si basa su next_update_time restituito dall'API Cloud Billing Subscription V3 sottostante. Questo campo viene compilato solo se una richiesta di soglia di abbonamento principale per l'indicizzazione degli aggiornamenti è andata a buon fine.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Solo output. Il tipo di aggiornamento eseguito in questa operazione. Questo campo viene compilato nella risposta di projects.patch.
agentSearchTokenSubscriptionStatuses[]

object (AgentSearchTokenSubscriptionStatus)

Solo output. Stato dell'abbonamento ai TPM per modello di ricerca dell'agente.

UpdateType

Il tipo di aggiornamento eseguito sulla configurazione di fatturazione configurabile.

Enum
UPDATE_TYPE_UNSPECIFIED Tipo di aggiornamento non specificato.
CREATE È stata creata/abilitata la fatturazione configurabile.
DELETE La fatturazione configurabile è stata eliminata/disattivata.
SCALE_UP L'abbonamento è stato aumentato (le soglie sono state aumentate).
SCALE_DOWN L'abbonamento è stato ridotto (le soglie sono diminuite).

AgentSearchTokenSubscriptionStatus

Stato dell'abbonamento TPM per modello di ricerca dell'agente. Una voce per ogni voce coreSubscription.agent_search_token_subscriptions[*] attiva nella configurazione fornita dal cliente; compilata da projects.patch e projects.get.

Gli scalari del ciclo di vita di questo messaggio (startTime, terminateTime, updateType, tpmThresholdNextUpdateTime) sono per (project, modelVersion), elementi correlati dell'intera relazione startTime / terminateTime / updateType in ConfigurableBillingStatus racchiuso, ma con ambito limitato a questo abbonamento TPM di Agent Search specifico anziché alla relazione di prezzo configurabile dal cliente complessiva. Questa granularità per istanza è intenzionale: lo spazio di archiviazione SubV3 sottostante è per (progetto, modelVersion), quindi ogni modello ha il proprio orologio di attivazione, terminazione e aggiornamento posticipato. La visualizzazione nella risposta offre ai clienti la granularità necessaria per gestire gli impegni per modello in modo indipendente. QPM / IndexingCore differiscono: il loro spazio di archiviazione è una riga per (progetto, posizione), quindi il loro ciclo di vita è rappresentato solo dagli scalari di relazione intera in ConfigurableBillingStatus.

Rappresentazione JSON 
{
  "modelVersion": string,
  "effectiveTpmThreshold": string,
  "tpmThresholdNextUpdateTime": string,
  "startTime": string,
  "terminateTime": string,
  "updateType": enum (UpdateType)
}
Campi
modelVersion

string

Solo output. La versione del modello Gemini a cui corrisponde questo stato. Corrisponde a CoreSubscription.AgentSearchTokenSubscription.model_version (una versione stabile del modello Gemini del registro delle versioni dei modelli di Gemini Enterprise Agent Platform; vedi https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
effectiveTpmThreshold

string (int64 format)

Solo output. La soglia TPM attualmente in vigore. Riflette lo scale up immediatamente e lo scale down al ciclo di fatturazione successivo, in linea con la semantica di effectiveSearchQpmThreshold.
tpmThresholdNextUpdateTime

string (Timestamp format)

Solo output. Il primo orario di aggiornamento successivo per la soglia di abbonamento TPM per questa (project, modelVersion). Viene compilato solo dopo un aggiornamento riuscito.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

Solo output. Data di attivazione iniziale di questo abbonamento TPM per la ricerca dell'agente (progetto, modelVersion). Impostato una sola volta alla prima attivazione di questa versione del modello e mai spostato dai successivi aggiornamenti della soglia; alla chiusura e alla riattivazione viene registrato un nuovo valore. NON sposta l'intera relazione startTime in ConfigurableBillingStatus contenitore, che continua a rappresentare la prima attivazione della relazione complessiva di determinazione dei prezzi configurabile dal cliente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
terminateTime

string (Timestamp format)

Solo output. Se impostato, l'ora effettiva pianificata in cui terminerà questo abbonamento TPM di Agent Search (progetto, modelVersion). Viene compilato quando il cliente rimuove questa voce da coreSubscription.agent_search_token_subscriptions[*]. NON sposta l'intero terminateTime della relazione in ConfigurableBillingStatus contenitore, che viene compilato solo quando viene eliminata l'intera relazione di determinazione dei prezzi configurabile dal cliente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateType

enum (UpdateType)

Solo output. Il tipo di aggiornamento più recente di questo abbonamento (project, modelVersion), eseguito dalle chiamate projects.patch più recenti. UPDATE_TYPE_UNSPECIFIED indica che questa versione del modello non è stata modificata dalla patch più recente dei progetti (il relativo effectiveTpmThreshold riflette un aggiornamento precedente). La relazione completa updateType in ConfigurableBillingStatus racchiuso continua a riassumere la direzione dell'aggiornamento più recente su tutte le superfici del progetto (QPM, IndexingCore e Agent Search TPM insieme).

Metodi

get

 Riceve un Project.

patch

 Aggiorna le impostazioni modificabili di un progetto Discovery Engine.

provision

 Esegue il provisioning della risorsa del progetto.

reportConsentChange

 Aggiorna i termini di servizio per questo progetto.