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

如需了解详情，请参阅授权指南。