创建用于上传内容的上传会话。对于小于 100 KB 的内容,将内容 inline
嵌入到 index
请求中会更容易。
此 API 需要管理员或服务账号才能执行。所使用的服务账号是相应数据源中已列入白名单的服务账号。
HTTP 请求
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*/items/*}:upload
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
用于启动可续传上传的内容的名称。格式:datasources/{sourceId}/items/{itemId}。最大长度为 1536 字节。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"connectorName": string,
"debugOptions": {
object ( |
字段 | |
---|---|
connectorName |
进行此调用的连接器的名称。 格式:datasources/{sourceId}/connectors/{ID} |
debugOptions |
常用调试选项。 |
响应正文
如果成功,则响应正文包含一个 UploadItemRef
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
有关详情,请参阅授权指南。