Method: projects.locations.corpora.assets.clip

다운로드할 클립을 생성합니다. API는 시간 범위를 사용하고 startTime 이후 endTime 이전에 사용 가능한 첫 번째 콘텐츠의 클립을 생성하며, 이 범위를 초과할 수 있습니다. 클립의 총 크기가 100MB를 초과하면 반환된 클립이 잘립니다.

HTTP 요청

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

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

경로 매개변수

매개변수
name

string

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

요청 본문

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

JSON 표현 
{
  "temporalPartition": {
    object (TemporalPartition)
  }
}
필드
temporalPartition

object (TemporalPartition)

필수 입력란입니다. 클립을 요청할 기간입니다.

응답 본문

assets.clip API의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "timeIndexedUris": [
    {
      object (TimeIndexedUri)
    }
  ]
}
필드
timeIndexedUris[]

object (TimeIndexedUri)

요청된 시간 범위를 다루는 동영상 클립을 다운로드하기 위한 서명된 uri 목록으로, 시간순으로 정렬됩니다.

승인 범위

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

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

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

IAM 권한

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

  • visionai.assets.clip

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

TimeIndexedUri

해당하는 기간으로 서명된 URI입니다.

JSON 표현 
{
  "temporalPartition": {
    object (TemporalPartition)
  },
  "uri": string
}
필드
temporalPartition

object (TemporalPartition)

URI가 적용되는 동영상의 시간 범위입니다.
uri

string

동영상 클립을 다운로드하기 위한 서명된 URI입니다.