REST Resource: projects

Ressource: Projekt

Metadaten und Konfigurationen für ein Google Cloud-Projekt im Dienst

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

string

Nur Ausgabe. Vollständiger Ressourcenname des Projekts, z. B. projects/{project}. Beachten Sie, dass bei Anfragen sowohl die Projektnummer als auch die Projekt-ID akzeptiert werden. Der Server antwortet jedoch immer mit der Projektnummer.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel des Zeitpunkts, zu dem dieses Projekt erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
provisionCompletionTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel des Zeitpunkts, zu dem dieses Projekt erfolgreich bereitgestellt wurde. Ein leerer Wert bedeutet, dass dieses Projekt noch bereitgestellt wird und daher noch nicht verwendet werden kann.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
serviceTermsMap

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

Nur Ausgabe. Eine Zuordnung der Nutzungsbedingungen. Der Schlüssel ist die id der ServiceTerms.
customerProvidedConfig

object (CustomerProvidedConfig)

Optional. Vom Kunden bereitgestellte Konfigurationen.
configurableBillingStatus

object (ConfigurableBillingStatus)

Nur Ausgabe. Der aktuelle Status der konfigurierbaren Abrechnung für das Projekt.

ServiceTerms

Metadaten zu den Nutzungsbedingungen

JSON-Darstellung 
{
  "id": string,
  "version": string,
  "state": enum (State),
  "acceptTime": string,
  "declineTime": string
}
Felder
id

string

Die eindeutige Kennung dieser Nutzungsbedingungen. Verfügbare Bedingungen:
version

string

Der Versionsstring für die Nutzungsbedingungen. Zulässige Werte finden Sie oben in den Kommentaren zur id.
state

enum (State)

Gibt an, ob die Nutzungsbedingungen für das Projekt akzeptiert oder abgelehnt wurden oder ob der Status noch ausstehend ist.
acceptTime

string (Timestamp format)

Der letzte Zeitpunkt, zu dem das Projekt den Nutzungsbedingungen zugestimmt hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
declineTime

string (Timestamp format)

Der letzte Zeitpunkt, zu dem das Projekt die Nutzungsbedingungen abgelehnt oder die Zustimmung zu den Nutzungsbedingungen widerrufen hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

State

Die Vereinbarungsstatus für diese Nutzungsbedingungen

Enums
STATE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
TERMS_ACCEPTED Das Projekt hat den Nutzungsbedingungen zugestimmt.
TERMS_PENDING Das Projekt muss die Nutzungsbedingungen noch überprüfen und akzeptieren.
TERMS_DECLINED Das Projekt hat die Nutzungsbedingungen abgelehnt oder die Vereinbarung widerrufen.

CustomerProvidedConfig

Vom Kunden bereitgestellte Konfigurationen.

JSON-Darstellung 
{
  "notebooklmConfig": {
    object (NotebooklmConfig)
  }
}
Felder
notebooklmConfig

object (NotebooklmConfig)

Optional. Konfiguration für die NotebookLM-Einstellungen.

NotebooklmConfig

Konfiguration für NotebookLM

JSON-Darstellung 
{
  "modelArmorConfig": {
    object (ModelArmorConfig)
  },
  "optOutNotebookSharing": boolean,
  "dataProtectionPolicy": {
    object (DataProtectionPolicy)
  },
  "observabilityConfig": {
    object (ObservabilityConfig)
  }
}
Felder
modelArmorConfig

object (ModelArmorConfig)

Model Armor-Konfiguration, die zum Bereinigen von Nutzer-Prompts und LLM-Antworten verwendet werden soll
optOutNotebookSharing

boolean

Optional. Gibt an, ob die Funktion zum Teilen von Notebooks für das Projekt deaktiviert werden soll. Wenn nicht angegeben, wird standardmäßig „false“ verwendet.
dataProtectionPolicy

object (DataProtectionPolicy)

Optional. Gibt die Datenschutzrichtlinie für NotebookLM an.
observabilityConfig

object (ObservabilityConfig)

Optional. Konfiguration der Beobachtbarkeit für NotebookLM.

ModelArmorConfig

Konfiguration für benutzerdefinierte Model Armor-Vorlagen, die zum Bereinigen von Nutzer-Prompts und LLM-Antworten verwendet werden sollen

JSON-Darstellung 
{
  "userPromptTemplate": string,
  "responseTemplate": string
}
Felder
userPromptTemplate

string

Optional. Der Ressourcenname der Model Armor-Vorlage zum Bereinigen von Nutzer-Prompts. Format: projects/{project}/locations/{location}/templates/{templateId}. Wenn nicht angegeben, wird der Nutzer-Prompt nicht bereinigt.
responseTemplate

string

Optional. Der Ressourcenname der Model Armor-Vorlage zum Bereinigen von LLM-Antworten. Format: projects/{project}/locations/{location}/templates/{templateId}. Wenn nicht angegeben, wird die LLM-Antwort nicht bereinigt.

DataProtectionPolicy

Konfiguration der Datenschutzrichtlinie für NotebookLM.

JSON-Darstellung 
{
  "sensitiveDataProtectionPolicy": {
    object (SensitiveDataProtectionPolicy)
  }
}
Felder
sensitiveDataProtectionPolicy

object (SensitiveDataProtectionPolicy)

Optional. Die Sensitive Data Protection-Richtlinie.

SensitiveDataProtectionPolicy

Gibt eine Sensitive Data Protection-Richtlinie (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview) an.

JSON-Darstellung 
{
  "policy": string
}
Felder
policy

string

Optional. Der Ressourcennamen der Sensitive Data Protection-Richtlinie.

ConfigurableBillingStatus

Die aktuell gültigen konfigurierbaren Abrechnungsparameter. Diese Werte werden aus dem intern gespeicherten Aboverlauf des Kunden abgeleitet und spiegeln die Grenzwerte wider, die zum Zeitpunkt des „projects.get“-Aufrufs aktiv für die Abrechnung verwendet werden. Dazu gehört auch die „startTime“ des Abos. Die Werte können sich aufgrund von Abrechnungsregeln von den Werten in customerProvidedConfig unterscheiden (z. B. werden Herunterskalierungen erst zu Beginn eines neuen Monats wirksam). Außerdem geben wir den Updatetyp an, um den Typ des Updates anzugeben, das für die konfigurierbare Abrechnungskonfiguration im Vorgang „projects.patch“ ausgeführt wurde.

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

string (int64 format)

Optional. Der aktuell gültige Schwellenwert für die Anzahl der Suchanfragen pro Minute. Anhand dieses Schwellenwerts werden Überschreitungen berechnet.
effectiveIndexingCoreThreshold

string (int64 format)

Optional. Der aktuell gültige Schwellenwert für den Indizierungskern. Dieser Schwellenwert wird für die Berechnung von Überschreitungen mit der Nutzung des Indizierungskerns verglichen.
startTime

string (Timestamp format)

Optional. Die Startzeit des aktuell aktiven Abrechnungsabos.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
terminateTime

string (Timestamp format)

Nur Ausgabe. Der letzte Zeitpunkt für die Kündigung von Such-QPM- und Indexierungs-Core-Abos.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
searchQpmThresholdNextUpdateTime

string (Timestamp format)

Nur Ausgabe. Der früheste Zeitpunkt für die nächste Aktualisierung des Grenzwerts für das QPM-Abo für die Suche. Dies basiert auf der next_update_time, die von der zugrunde liegenden Cloud Billing Subscription V3 API zurückgegeben wird. Dieses Feld wird nur ausgefüllt, wenn eine Anfrage zum Aktualisieren des QPM-Abo-Schwellenwerts erfolgreich war.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
indexingCoreThresholdNextUpdateTime

string (Timestamp format)

Nur Ausgabe. Der früheste Zeitpunkt für die nächste Aktualisierung des Schwellenwerts für das Indexierungs-Core-Abo. Dies basiert auf der next_update_time, die von der zugrunde liegenden Cloud Billing Subscription V3 API zurückgegeben wird. Dieses Feld wird nur ausgefüllt, wenn eine Anfrage zum Aktualisieren des Schwellenwerts für die Indexierung von Kernabos erfolgreich war.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateType

enum (UpdateType)

Nur Ausgabe. Die Art der Aktualisierung, die bei diesem Vorgang durchgeführt wurde. Dieses Feld wird in der Antwort von „projects.patch“ ausgefüllt.
agentSearchTokenSubscriptionStatuses[]

object (AgentSearchTokenSubscriptionStatus)

Nur Ausgabe. Status des TPM-Abos für die Suche mit Agenten pro Modell.

UpdateType

Die Art der Aktualisierung, die an der konfigurierbaren Abrechnungskonfiguration vorgenommen wurde.

Enums
UPDATE_TYPE_UNSPECIFIED Nicht angegebener Aktualisierungstyp.
CREATE Die konfigurierbare Abrechnung wurde erstellt/aktiviert.
DELETE Die konfigurierbare Abrechnung wurde gelöscht/deaktiviert.
SCALE_UP Das Abo wurde hochgestuft (die Grenzwerte wurden erhöht).
SCALE_DOWN Das Abo wurde herabgestuft (Grenzwerte wurden gesenkt).

AgentSearchTokenSubscriptionStatus

Status des TPM-Abos für die Agent Search-Funktion pro Modell. Ein Eintrag pro aktivem coreSubscription.agent_search_token_subscriptions[*]-Eintrag in der vom Kunden bereitgestellten Konfiguration; wird durch „projects.patch“ und „projects.get“ ausgefüllt.

Die Lebenszyklus-Skalare in dieser Nachricht (startTime, terminateTime, updateType, tpmThresholdNextUpdateTime) gelten pro (Projekt, Modellversion) – sie sind Geschwister der gesamten Beziehung startTime / terminateTime / updateType im einschließenden ConfigurableBillingStatus, aber auf dieses spezifische Agent Search TPM-Abo beschränkt und nicht auf die gesamte vom Kunden konfigurierbare Preisbeziehung. Diese Granularität pro Instanz ist beabsichtigt: Der zugrunde liegende SubV3-Speicher ist pro (Projekt, Modellversion). Daher hat jedes Modell seinen eigenen Aktivierungs-, Beendigungs- und verzögerten Aktualisierungszeitraum. Wenn diese Informationen in der Antwort angezeigt werden, erhalten Kunden die erforderliche Granularität, um Verpflichtungen pro Modell unabhängig voneinander zu verwalten. QPM / IndexingCore unterscheiden sich – ihr Speicherplatz ist eine Zeile pro (Projekt, Standort), sodass ihr Lebenszyklus nur durch die Skalare für die gesamte Beziehung in „ConfigurableBillingStatus“ dargestellt wird.

JSON-Darstellung 
{
  "modelVersion": string,
  "effectiveTpmThreshold": string,
  "tpmThresholdNextUpdateTime": string,
  "startTime": string,
  "terminateTime": string,
  "updateType": enum (UpdateType)
}
Felder
modelVersion

string

Nur Ausgabe. Die Gemini-Modellversion, der dieser Status entspricht. Entspricht CoreSubscription.AgentSearchTokenSubscription.model_version (einer stabilen Gemini-Modellversion aus der Modellversionsregistrierung der Gemini Enterprise Agent Platform; siehe https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models)).
effectiveTpmThreshold

string (int64 format)

Nur Ausgabe. Der aktuell gültige TPM-Schwellenwert. Wird sofort hochskaliert und im nächsten Abrechnungszeitraum herunterskaliert, entsprechend der Semantik von effectiveSearchQpmThreshold.
tpmThresholdNextUpdateTime

string (Timestamp format)

Nur Ausgabe. Der früheste Zeitpunkt für die nächste Aktualisierung des TPM-Abo-Schwellenwerts für dieses (Projekt, modelVersion). Wird erst nach einem erfolgreichen Update ausgefüllt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
startTime

string (Timestamp format)

Nur Ausgabe. Wann dieses TPM-Abo für die Agent Search-Funktion (Projekt, modelVersion) zum ersten Mal aktiviert wurde. Wird bei der ersten Aktivierung dieser Modellversion einmal festgelegt und durch nachfolgende Schwellenwertaktualisierungen nicht geändert. Bei Beendigung und Reaktivierung wird ein neuer Wert aufgezeichnet. Verschiebt NICHT die gesamte Beziehung startTime im einschließenden ConfigurableBillingStatus, der weiterhin die erste Aktivierung der gesamten Beziehung für vom Kunden konfigurierbare Preise darstellt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
terminateTime

string (Timestamp format)

Nur Ausgabe. Wenn festgelegt, die geplante effektive Zeit, zu der dieses (Projekt, modelVersion) Agent Search TPM-Abo endet. Wird ausgefüllt, wenn der Kunde diesen Eintrag aus coreSubscription.agent_search_token_subscriptions[*] entfernt. Verschiebt NICHT die gesamte Beziehung terminateTime im einschließenden ConfigurableBillingStatus, der nur ausgefüllt wird, wenn die gesamte vom Kunden konfigurierbare Preisbeziehung beendet wird.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateType

enum (UpdateType)

Nur Ausgabe. Der Typ der letzten Aktualisierung dieses Abos (Projekt, „modelVersion“), die durch den letzten „projects.patch“-Aufruf ausgeführt wurde. UPDATE_TYPE_UNSPECIFIED gibt an, dass diese „modelVersion“ nicht vom letzten „projects.patch“ betroffen war (die effectiveTpmThreshold spiegelt ein früheres Update wider). Die Beziehung updateType für den einschließenden ConfigurableBillingStatus fasst weiterhin die Richtung des letzten Updates für alle Oberflächen im Projekt zusammen (QPM, IndexingCore und Agent Search TPM zusammen).

Methoden

get

 Ruft ein Project ab

patch

 Aktualisiert die änderbaren Einstellungen eines Discovery Engine-Projekts

provision

 Stellt die Projektressource bereit

reportConsentChange

 Aktualisiert die Nutzungsbedingungen für dieses Projekt