Method: media.upload

上传媒体内容以编入索引。

上传端点支持直接和可续传上传协议，适用于无法在索引请求期间内嵌的大型内容。如需将大型内容编入索引，请执行以下操作：

  1. 使用商品名称调用 indexing.datasources.items.upload 以开始上传会话并检索 UploadItemRef。
  2. 使用步骤 1 中的 UploadItemRef 中的相同资源名称，以流式传输请求的形式调用 media.upload 来上传内容。
  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

有关详情，请参阅授权指南。