Method: indexing.datasources.items.index

Item の ACL、メタデータ、コンテンツを更新します。Item が存在しない場合は、挿入されます。この方法では部分的な更新はサポートされていません。値が指定されていないフィールドは、Cloud Search インデックスで消去されます。

この API を実行するには、管理者またはサービス アカウントが必要です。使用されるサービス アカウントが、対応するデータソースの許可リストに登録されている。

HTTP リクエスト

POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
item.name

string

アイテムの名前。形式: datasources/{sourceId}/items/{itemId}

これは必須項目です。最大長は 1,536 文字です。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "item": {
    "name": string,
    "acl": {
      "inheritAclFrom": string,
      "aclInheritanceType": enum (ItemAcl.AclInheritanceType),
      "readers": [
        {
          object (Principal)
        }
      ],
      "deniedReaders": [
        {
          object (Principal)
        }
      ],
      "owners": [
        {
          object (Principal)
        }
      ]
    },
    "metadata": {
      "title": string,
      "sourceRepositoryUrl": string,
      "containerName": string,
      "objectType": string,
      "createTime": string,
      "updateTime": string,
      "interactions": [
        {
          object (Interaction)
        }
      ],
      "contentLanguage": string,
      "mimeType": string,
      "searchQualityMetadata": {
        object (SearchQualityMetadata)
      },
      "keywords": [
        string
      ],
      "hash": string,
      "contextAttributes": [
        {
          object (ContextAttribute)
        }
      ]
    },
    "structuredData": {
      "object": {
        object (StructuredDataObject)
      },
      "hash": string
    },
    "content": {
      "contentFormat": enum (ItemContent.ContentFormat),
      "hash": string,

      // Union field content can be only one of the following:
      "inlineContent": string,
      "contentDataRef": {
        object (UploadItemRef)
      }
      // End of list of possible types for union field content.
    },
    "version": string,
    "status": {
      "code": enum (ItemStatus.Code),
      "processingErrors": [
        {
          object (ProcessingError)
        }
      ],
      "repositoryErrors": [
        {
          object (RepositoryError)
        }
      ]
    },
    "queue": string,
    "payload": string,
    "itemType": enum (Item.ItemType)
  },
  "connectorName": string,
  "mode": enum (RequestMode.Mode),
  "debugOptions": {
    object (DebugOptions)
  },
  "indexItemOptions": {
    object (IndexItemOptions)
  }
}
フィールド
item.acl

object (ItemAcl)

このアイテムのアクセス制御リスト。

item.metadata

object (ItemMetadata)

メタデータ情報。

item.structuredData

object (ItemStructuredData)

データソースのスキーマに登録されているオブジェクト定義に準拠する必要があるアイテムの構造化データ。

item.content

object (ItemContent)

インデックスに登録され、テキストを検索可能にするアイテム コンテンツ。

item.version

string (bytes format)

必須。インデックス システムは、データソースのバージョンをバイト文字列として格納し、語彙の順序付けを使用して、インデックス内の Item のバージョンとキューに格納された Item のバージョンを比較します。

キューに追加されたアイテムのバージョンが、現在インデックスに登録されているアイテムのバージョン以下の値である場合、Cloud Search Indexing は、それらのアイテムをインデックス登録または削除しません。このフィールドの最大長は 1,024 バイトです。

アイテムのバージョンが削除プロセスに与える影響について詳しくは、手動で削除した後の変更内容を処理するをご覧ください。

Base64 でエンコードされた文字列。

item.status

object (ItemStatus)

アイテムのステータス。出力専用フィールド。

item.queue

string

このアイテムが属するキューに追加します。最大で 100 文字です。

item.payload

string (bytes format)

このアイテムに保存できる追加の状態コネクタです。最大長は 10,000 バイトです。

Base64 でエンコードされた文字列。

item.itemType

enum (Item.ItemType)

このアイテムのタイプ。

connectorName

string

この呼び出しを行うコネクタの名前。

形式: datasources/{sourceId}/connectors/{ID}

mode

enum (RequestMode.Mode)

必須。このリクエストの RequestMode。

debugOptions

object (DebugOptions)

一般的なデバッグ オプション。

indexItemOptions

object (IndexItemOptions)

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認証スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

詳細については、承認ガイドをご覧ください。

IndexItemOptions

JSON 表現
{
  "allowUnknownGsuitePrincipals": boolean
}
フィールド
allowUnknownGsuitePrincipals

boolean

存在しない Google Workspace プリンシパルや削除された Google Workspace プリンシパルをインデックス リクエストで許可するかどうかを指定します。