Method: indexing.datasources.items.push

後でポーリングして更新できるように、アイテムをキューに push します。

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
item.name

string

インデックス登録キューに push する item の名前。

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

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

リクエスト本文

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

JSON 表現 
{
  "item": {
    "name": string,
    "type": enum (PushItem.Type),
    "metadataHash": string,
    "structuredDataHash": string,
    "contentHash": string,
    "payload": string,
    "queue": string,
    "repositoryError": {
      "type": enum (RepositoryError.Type),
      "httpStatusCode": integer,
      "errorMessage": string
    }
  },
  "connectorName": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
フィールド
item.type

enum (PushItem.Type)

push 動作を定義する push オペレーションのタイプ。
item.metadataHash

string

リポジトリに従うアイテムのメタデータ ハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと type フィールドを設定すると、引数エラーが発生します。最大文字数は 2,048 文字です。
item.structuredDataHash

string

リポジトリに従ったアイテムの構造化データのハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと type フィールドを設定すると、引数エラーが発生します。最大文字数は 2,048 文字です。
item.contentHash

string

リポジトリに従ったアイテムのコンテンツ ハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと type フィールドを設定すると、引数エラーが発生します。最大文字数は 2,048 文字です。
item.payload

string (bytes format)

代替リポジトリ ID などのメタデータなど、コネクタのドキュメントの状態に関する追加情報を提供します。最大長は 8,192 バイトです。

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

string

このアイテムが属するキュー。このフィールドが指定されていない場合は、default キューが選択されます。最大長は 512 文字です。
item.repositoryError

object (RepositoryError)

コネクタまたはリポジトリのエラーの詳細を保存するには、このフィールドに入力します。この情報は管理コンソールに表示されます。このフィールドは、type が REPOSITORY_ERROR の場合にのみ入力できます。
connectorName

string

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

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

object (DebugOptions)

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

レスポンスの本文

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

認可スコープ

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

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

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

PushItem

インデックス登録キューにプッシュされるアイテムを表します。

JSON 表現 
{
  "name": string,
  "type": enum (PushItem.Type),
  "metadataHash": string,
  "structuredDataHash": string,
  "contentHash": string,
  "payload": string,
  "queue": string,
  "repositoryError": {
    object (RepositoryError)
  }
}
フィールド
name

string

インデックス登録キューに push する item の名前。

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

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

enum (PushItem.Type)

push 動作を定義する push オペレーションのタイプ。
metadataHash

string

リポジトリに従うアイテムのメタデータ ハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと type フィールドを設定すると、引数エラーが発生します。最大文字数は 2,048 文字です。
structuredDataHash

string

リポジトリに従ったアイテムの構造化データのハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと type フィールドを設定すると、引数エラーが発生します。最大文字数は 2,048 文字です。
contentHash

string

リポジトリに従ったアイテムのコンテンツ ハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと type フィールドを設定すると、引数エラーが発生します。最大文字数は 2,048 文字です。
payload

string (bytes format)

代替リポジトリ ID などのメタデータなど、コネクタのドキュメントの状態に関する追加情報を提供します。最大長は 8,192 バイトです。

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

string

このアイテムが属するキュー。このフィールドが指定されていない場合は、default キューが選択されます。最大長は 512 文字です。
repositoryError

object (RepositoryError)

コネクタまたはリポジトリのエラーの詳細を保存するには、このフィールドに入力します。この情報は管理コンソールに表示されます。このフィールドは、type が REPOSITORY_ERROR の場合にのみ入力できます。

PushItem.Type

push 動作を定義する push オペレーションのタイプ。

列挙型
UNSPECIFIED デフォルトは UNSPECIFIED です。push オペレーションで ItemStatus を変更しないことを指定します。
MODIFIED 前回の update 呼び出し以降に、リポジトリ ドキュメントが変更または更新されたことを示します。既存のアイテムのステータスを MODIFIED に変更します。このフィールドが既存のアイテム以外に対して呼び出されると、ステータスは NEW_ITEM に変更されます。
NOT_MODIFIED 前回の update 呼び出し以降、リポジトリ内のアイテムが変更されていません。この push オペレーションは、ステータスを ACCEPTED 状態に設定します。
REPOSITORY_ERROR このアイテムに関するリポジトリ エラーがコネクタで発生しています。ステータスを REPOSITORY_ERROR に変更します。アイテムは予約解除され、指数バックオフによって決定される将来の時刻に再スケジュールされます。
REQUEUE 予約済みのアイテムに対してのみ、REQUEUE を使用してプッシュ呼び出しを行います。この操作を行うと、アイテムの予約が解除され、利用可能な時間が実時間にリセットされます。