Method: media.upload

上傳媒體以供索引。

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

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

如需更多資訊，請參閱「使用 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

詳情請參閱授權指南。