Method: media.upload

上傳要建立索引的媒體。

上傳端點支援直接和可續傳的上傳通訊協定，適用於無法在索引要求期間內嵌的大型項目。如何索引大型內容：

  1. 使用項目名稱呼叫 indexing.datasources.items.upload，啟動上傳工作階段並擷取 UploadItemRef。
  2. 呼叫 media.upload，以串流要求的形式上傳內容，並使用步驟 1 中 UploadItemRef 的相同資源名稱。
  3. 呼叫 indexing.datasources.items.index 即可為項目建立索引。在 ItemContent 中填入步驟 1 的 UploadItemRef。

詳情請參閱使用 REST API 建立內容連接器。

注意：這個 API 需要服務帳戶才能執行。

HTTP 要求

  • 上傳 URI (適用於媒體上傳要求)：
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • 中繼資料 URI (適用於僅中繼資料的要求)：
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
resourceName

string

所下載的媒體名稱。詳情請參閱《ReadRequest.resource_name》。

要求主體

要求主體包含 Media 的例項。

回應主體

如果成功，回應主體會含有以下結構的資料：

媒體資源。

JSON 表示法 
{
  "resourceName": string
}
欄位
resourceName

string

媒體資源名稱。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

詳情請參閱授權指南。