Lade das Asset hoch, indem du die Cloud Storage-URI des Assets angibst. Für das Video-Warehouse benötigen Nutzer, die diese API aufrufen, Lesezugriff auf die Cloud Storage-Datei. Nach dem Hochladen kann die Datei über die API „assets.generateRetrievalUrl“ abgerufen werden. Standardmäßig können nur Cloud Storage-Dateien aus demselben Projekt des Repositories abgerufen werden. Wenn Sie Cloud Storage-Dateien abrufen möchten, die sich in einem separaten Projekt befinden, müssen Sie das Vision AI-Dienstkonto finden (gehen Sie zu IAM, klicken Sie das Kästchen für „Von Google bereitgestellte Rollenzuweisungen einschließen“ an und suchen Sie nach „Cloud Vision AI Service Agent“). Gewähren Sie dann diesem Dienstkonto Lesezugriff auf die Cloud Storage-Dateien.
HTTP-Anfrage
POST https://visionai.googleapis.com/v1/{name=projects/*/locations/*/corpora/*/assets/*}:upload
Pflichtangabe. Der Ressourcenname des Assets, das hochgeladen werden soll. Format: projects/{project_number}/locations/{locationId}/corpora/{corpus_id}/assets/{assetId}
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
{// Union field source_form can be only one of the following:"assetGcsSource": {object (AssetGcsSource)},"assetContentData": {object (AssetContentData)}// End of list of possible types for union field source_form.}
Felder
Union-Feld source_form.
Für source_form ist nur einer der folgenden Werte zulässig:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-03-04 (UTC)."],[],[],null,["# Method: projects.locations.corpora.assets.upload\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [AssetSource](#AssetSource)\n - [JSON representation](#AssetSource.SCHEMA_REPRESENTATION)\n- [AssetContentData](#AssetContentData)\n - [JSON representation](#AssetContentData.SCHEMA_REPRESENTATION)\n\nUpload asset by specifing the asset Cloud Storage uri. For video warehouse, it requires users who call this API have read access to the cloud storage file. Once it is uploaded, it can be retrieved by assets.generateRetrievalUrl API which by default, only can retrieve cloud storage files from the same project of the warehouse. To allow retrieval cloud storage files that are in a separate project, it requires to find the vision ai service account (Go to IAM, check checkbox to show \"Include Google-provided role grants\", search for \"Cloud Vision AI Service Agent\") and grant the read access of the cloud storage files to that service account.\n\n### HTTP request\n\n`POST https://visionai.googleapis.com/v1/{name=projects/*/locations/*/corpora/*/assets/*}:upload`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/vision-ai/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `visionai.assets.upload`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs).\n\nAssetSource\n-----------\n\nThe source of the asset.\n\nAssetContentData\n----------------\n\nThe content of the asset."]]