Item
の ACL、メタデータ、コンテンツを更新します。Item
が存在しない場合は挿入されます。この方法では、部分的な更新はサポートされていません。値が指定されていないフィールドは Cloud Search インデックスから消去されます。
この API を実行するには、管理者またはサービス アカウントが必要です。使用されるサービス アカウントは、対応するデータソースの許可リストに登録されているアカウントである。
HTTP リクエスト
POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
item.name |
アイテムの名前。形式: datasources/{sourceId}/items/{itemId} これは必須項目です。最大文字数は 1,536 文字です。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "item": { "name": string, "acl": { "inheritAclFrom": string, "aclInheritanceType": enum ( |
フィールド | |
---|---|
item.acl |
このアイテムのアクセス制御リスト。 |
item.metadata |
メタデータ情報。 |
item.structuredData |
データソースのスキーマに登録されているオブジェクト定義に適合するアイテムの構造化データ。 |
item.content |
インデックスに登録され、テキストを検索可能にするアイテムのコンテンツ。 |
item.version |
必須。インデックス登録システムは、データソースのバージョンをバイト文字列として格納し、インデックス内のアイテムのバージョンと、キューに追加されたアイテムのバージョンを字句順で比較します。 Cloud Search インデックスでは、現在インデックス登録されているアイテムのバージョン値以下のバージョン値を持つキューに追加されたアイテムが、インデックス登録も削除もされません。このフィールドの最大長は 1,024 バイトです。 アイテムのバージョンが削除プロセスに与える影響については、手動削除後のリビジョンを処理するをご覧ください。 Base64 でエンコードされた文字列。 |
item.status |
商品アイテムのステータス。出力専用フィールド。 |
item.queue |
このアイテムが属するキュー。最大で 100 文字です。 |
item.payload |
このアイテム用に追加の状態コネクタを保存できます。最大長は 10,000 バイトです。 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 プリンシパルを許可するかどうかを指定します。 |