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

詳情請參閱授權指南。