更新 Item
ACL、元数据和内容。如果 Item
不存在,则执行插入操作。此方法不支持部分更新。未提供值的字段会在 Cloud Search 索引中清除。
此 API 需要管理员或服务帐号才能执行。使用的服务帐号是相应数据源中列入白名单的服务帐号。
HTTP 请求
POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
item.name |
商品的名称。格式:datasources/{sourceId}/items/{itemId} 这是必填字段。长度上限为 1536 个字符。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "item": { "name": string, "acl": { "inheritAclFrom": string, "aclInheritanceType": enum ( |
字段 | |
---|---|
item.acl |
此项的访问权限控制列表。 |
item.metadata |
元数据信息。 |
item.structuredData |
项的结构化数据,这些数据应与数据源架构中已注册的对象定义相符。 |
item.content |
要编入索引并支持文本可搜索的商品内容。 |
item.version |
必需。索引系统将数据源中的版本存储为字节字符串,并使用词法排序将索引中的项版本与已加入队列的项的版本进行比较。 Cloud Search Indexing 不会将版本值小于或等于当前编入索引项的版本的任何排队项编入索引或删除。此字段的长度上限为 1024 字节。 如需了解内容版本对删除过程有何影响,请参阅在手动删除后处理修订版本。 使用 base64 编码的字符串。 |
item.status |
商品的状态。仅限输出字段。 |
item.queue |
此项所属的队列。长度上限为 100 个字符。 |
item.payload |
可以为此项存储其他状态连接器。最大长度为 10000 字节。 使用 base64 编码的字符串。 |
item.itemType |
此项目的类型。 |
connectorName |
进行此调用的连接器的名称。 格式:datasources/{sourceId}/connectors/{ID} |
mode |
必需。此请求的 RequestMode。 |
debugOptions |
常用的调试选项。 |
indexItemOptions |
|
响应正文
如果成功,则响应正文包含一个 Operation
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
有关详情,请参阅授权指南。
IndexItemOptions
JSON 表示法 |
---|
{ "allowUnknownGsuitePrincipals": boolean } |
字段 | |
---|---|
allowUnknownGsuitePrincipals |
指定索引请求是否应允许不存在或已被删除的 Google Workspace 主帐号。 |