Method: projects.locations.corpora.assets.clip

產生可供下載的短片。API 會擷取時間範圍，並產生第一個可用的內容片段，該片段的時間範圍介於 startTime 和 endTime 之間，但可能會超出這些範圍。如果短片的總大小超過 100 MB，系統會截斷傳回的短片。

HTTP 要求

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

這個網址使用 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

詳情請參閱 身分與存取權管理說明文件。

TimeIndexedUri

已簽署的 URI 和對應的時間範圍。

JSON 表示法 
{
  "temporalPartition": {
    object (TemporalPartition)
  },
  "uri": string
}
欄位
temporalPartition

object (TemporalPartition)

此 URI 所屬影片的時間範圍。
uri

string

用於下載影片片段的已簽署 URI。