Method: projects.locations.corpora.assets.upload

Carica la risorsa specificandone l'URI Cloud Storage. Per il magazzino video, è necessario che gli utenti che richiamano questa API dispongano dell'accesso in lettura al file di archiviazione sul cloud. Una volta caricato, può essere recuperato dall'API assets.generateRetrievalUrl che, per impostazione predefinita, può recuperare i file di Cloud Storage solo dallo stesso progetto del magazzino. Per consentire il recupero dei file di Cloud Storage in un progetto separato, è necessario trovare l'account di servizio AI per la visione (vai a IAM, seleziona la casella di controllo per visualizzare "Includi concessioni di ruoli fornite da Google", cerca "Agente di servizio AI per la visione di Cloud") e concedere l'accesso in lettura ai file di Cloud Storage a quell'account di servizio.

Richiesta HTTP

POST https://visionai.googleapis.com/v1/{name=projects/*/locations/*/corpora/*/assets/*}:upload

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome della risorsa dell'asset da caricare. Formato: projects/{project_number}/locations/{locationId}/corpora/{corpus_id}/assets/{assetId}

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "assetSource": {
    object (AssetSource)
  }
}
Campi
assetSource

object (AssetSource)

L'origine della risorsa.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • visionai.assets.upload

Per ulteriori informazioni, consulta la documentazione di IAM.

AssetSource

L'origine della risorsa.

Rappresentazione JSON 
{

  // 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.
}
Campi

Campo unione source_form.

source_form può essere solo uno dei seguenti:
assetGcsSource

object (AssetGcsSource)

L'origine della risorsa proviene da Cloud Storage.
assetContentData

object (AssetContentData)

L'origine della risorsa proviene dai byte dei contenuti.

AssetContentData

I contenuti della risorsa.

Rappresentazione JSON 
{
  "assetContentData": string
}
Campi
assetContentData

string (bytes format)

Una stringa con codifica Base64.