创建用于上传商品内容的上传会话。对于小于 100 KB 的内容,更容易在 index 请求中嵌入内容 inline。
此 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
如需了解详情,请参阅授权指南。