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

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