Warehouse-Asset erstellen und aktualisieren

Ein verbundenes Vision Warehouse (corpus) in einer bereitgestellten App, die Daten aufnimmt, enthält eine oder mehrere Media-Objekt-Ressourcen (z. B. Videoressourcen). Diese Media-Objekte (asset-Ressourcen) enthalten Metadaten und Ressourcenanmerkungen. Verwenden Sie die folgenden Befehle, um diese Media-Objekte zu erstellen und zu aktualisieren.

Streaming-Video-Warehouse-Asset erstellen

Nachdem Sie ein Warehouse erstellt haben (corpus-Ressource), können Sie dem Warehouse eine oder mehrere Video-asset-Ressourcen hinzufügen.

REST UND BEFEHLSZEILE

Mit dem folgenden Code wird ein neues Asset im angegebenen Warehouse (corpus) erstellt. Dabei kann die ID des Assets und eine TTL angegeben werden.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGIONALIZED_ENDPOINT: Der Endpunkt kann ein Präfix enthalten, das mit dem LOCATION_ID übereinstimmt, z. B. europe-west4-. Weitere Informationen zu regionalisierten Endpunkten
  • PROJECT_NUMBER: Ihre Google Cloud Projektnummer.
  • LOCATION_ID: Die Region, in der Sie Agent Platform Vision verwenden. Beispiel: us-central1, europe-west4. Verfügbare Regionen
  • CORPUS_ID: Die ID des Zielkorpus.
  • ASSET_ID: (Optional) Ein vom Nutzer angegebener Wert für die Asset-ID. In dieser Anfrage wird der Wert in der folgenden Form in die Anfrage-URL eingefügt:
    • https://ENDPOINT/v1/[...]/corpora/CORPUS_ID/assets?asset_id=ASSET_ID
  • TIME_TO_LIVE: Die Gültigkeitsdauer (TTL) für alle Assets in einem Korpus oder die TTL eines bestimmten Assets. Geben Sie beispielsweise für einen Korpus mit Assets mit einer TTL von 100 Tagen den Wert 8640000 (Sekunden) an.

HTTP-Methode und URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets

JSON-Text der Anfrage:

{
  "ttl": {
    "seconds": TIME_TO_LIVE
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets"

PowerShell

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID",
  "ttl": "TIME_TO_LIVEs"
}

Vision SDK für die Gemini Enterprise Agent Platform

Wenn Sie eine Anfrage zum Lesen eines Modellausgabe-Streams senden möchten, müssen Sie das Gemini Enterprise Agent Platform Vision SDK installieren.

Wenn Sie das vaictl-Befehlszeilentool zum Erstellen eines Assets verwenden, können Sie keine Asset-ID oder TTL angeben.

Ersetzen Sie die folgenden Variablen:

vaictl --project-id=PROJECT_NUMBER \
--location-id=LOCATION_ID \
--service-endpoint=warehouse-visionai.googleapis.com \
create asset CORPUS_ID

Nachdem ein Asset erstellt wurde, können Sie mit dem vaictl-Befehlszeilentool Videodaten direkt in das Data Warehouse für dieses Asset aufnehmen.

Streamingvideo-Warehouse-Asset aktualisieren

Verwenden Sie das folgende Codebeispiel, um die Gültigkeitsdauer (Time-to-Live, TTL) eines Assets zu aktualisieren. Sie können nur das TTL-Feld aktualisieren.

Verwenden Sie den Abfrageparameter updateMask im folgenden Codebeispiel, um die TTL eines Assets zu aktualisieren. Sie können einen Abfrageparameter verwenden, um nur das TTL-Feld zu aktualisieren. So funktioniert updateMask:

  • Wenn angegeben, werden nur die Felder in der updateMask aktualisiert.
  • Wenn der Wert der Aktualisierungsmaske * ist, werden durch die Anfrage alle Felder aktualisiert.

  • Wenn die Aktualisierungsmaske nicht angegeben ist, werden nur die Felder in der Anfrage-URL aktualisiert, für die im Anfragetext ein Wert angegeben ist.

REST UND BEFEHLSZEILE

In den folgenden Codebeispielen wird die TTL eines Assets mit der Methode projects.locations.corpora.assets.patch geändert.

TTL-Wert ändern

In diesem Beispiel wird ?updateMask=ttl in der Anfrage-URL verwendet und ein neuer ttl.seconds-Wert im Anfragetext eingefügt, um das Asset zu aktualisieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGIONALIZED_ENDPOINT: Der Endpunkt kann ein Präfix enthalten, das mit dem LOCATION_ID übereinstimmt, z. B. europe-west4-. Weitere Informationen zu regionalisierten Endpunkten
  • PROJECT_NUMBER: Ihre Google Cloud Projektnummer.
  • LOCATION_ID: Die Region, in der Sie Agent Platform Vision verwenden. Beispiel: us-central1, europe-west4. Verfügbare Regionen
  • CORPUS_ID: Die ID des Zielkorpus.
  • ASSET_ID: Die ID des Ziel-Assets.
  • ?updateMask=fieldToUpdate: Eines der verfügbaren Felder, auf das Sie eine updateMask anwenden können. Verfügbare Felder:
    • Gültigkeitsdauer (TTL): ?updateMask=ttl
    • Aktualisieren Sie alle Felder: ?updateMask=*

HTTP-Methode und URL: 

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

JSON-Text der Anfrage:

{
  "ttl": {
    "seconds": "1"
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl"

PowerShell

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
}

TTL-Wert entfernen

In diesem Beispiel wird ?updateMask=ttl in der Anfrage-URL verwendet und ein leerer Anfragetext eingefügt, um den TTL-Wert des Assets zu löschen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • REGIONALIZED_ENDPOINT: Der Endpunkt kann ein Präfix enthalten, das mit dem LOCATION_ID übereinstimmt, z. B. europe-west4-. Weitere Informationen zu regionalisierten Endpunkten
  • PROJECT_NUMBER: Ihre Google Cloud Projektnummer.
  • LOCATION_ID: Die Region, in der Sie Agent Platform Vision verwenden. Beispiel: us-central1, europe-west4. Verfügbare Regionen
  • CORPUS_ID: Die ID des Zielkorpus.
  • ASSET_ID: Die ID des Ziel-Assets.
  • ?updateMask=fieldToUpdate: Eines der verfügbaren Felder, auf das Sie eine updateMask anwenden können. Verfügbare Felder:
    • Gültigkeitsdauer (TTL): ?updateMask=ttl
    • Aktualisieren Sie alle Felder: ?updateMask=*

HTTP-Methode und URL: 

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl

JSON-Text der Anfrage:

{}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl"

PowerShell

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID?updateMask=ttl" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID"
}