Method: projects.locations.corpora.assets.upload

애셋 Cloud Storage uri를 지정하여 애셋을 업로드합니다. 동영상 창고의 경우 이 API를 호출하는 사용자가 클라우드 스토리지 파일에 대한 읽기 액세스 권한이 있어야 합니다. 업로드되면 assets.generateRetrievalUrl API를 통해 검색할 수 있으며, 이 API는 기본적으로 창고와 동일한 프로젝트의 Cloud Storage 파일만 검색할 수 있습니다. 별도의 프로젝트에 있는 Cloud Storage 파일을 검색하려면 Vision AI 서비스 계정을 찾아야 합니다 (IAM으로 이동하여 'Google 제공 역할 부여 포함'을 표시하도록 체크박스를 선택하고 'Cloud Vision AI 서비스 에이전트'를 검색). 그런 다음 해당 서비스 계정에 Cloud Storage 파일의 읽기 액세스 권한을 부여합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 입력란입니다. 업로드할 저작물의 리소스 이름입니다. 형식: projects/{project_number}/locations/{locationId}/corpora/{corpus_id}/assets/{assetId}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "assetSource": {
    object (AssetSource)
  }
}
필드
assetSource

object (AssetSource)

저작물의 소스입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • visionai.assets.upload

자세한 내용은 IAM 문서를 참조하세요.

AssetSource

저작물의 소스입니다.

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.
}
필드

통합 필드 source_form.

source_form는 다음 중 하나여야 합니다.
assetGcsSource

object (AssetGcsSource)

저작물의 소스는 Cloud Storage입니다.
assetContentData

object (AssetContentData)

애셋의 소스는 콘텐츠 바이트에서 가져옵니다.

AssetContentData

저작물의 콘텐츠입니다.

JSON 표현 
{
  "assetContentData": string
}
필드
assetContentData

string (bytes format)

base64 인코딩 문자열입니다.