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

有关详情,请参阅 OAuth 2.0 概览