後でポーリングして更新できるように、アイテムをキューに push します。
この API を実行するには、管理者またはサービス アカウントが必要です。使用されるサービス アカウントは、対応するデータソースの許可リストに登録されているアカウントである。
HTTP リクエスト
POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:push
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
item.name |
インデックス登録キューに push する 形式: datasources/{sourceId}/items/{ID} これは必須項目です。最大文字数は 1,536 文字です。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "item": { "name": string, "type": enum ( |
フィールド | |
---|---|
item.type |
push 動作を定義する push オペレーションのタイプ。 |
item.metadataHash |
リポジトリに従うアイテムのメタデータ ハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと |
item.structuredDataHash |
リポジトリに従ったアイテムの構造化データのハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと |
item.contentHash |
リポジトリに従ったアイテムのコンテンツ ハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと |
item.payload |
代替リポジトリ ID などのメタデータなど、コネクタのドキュメントの状態に関する追加情報を提供します。最大長は 8,192 バイトです。 Base64 でエンコードされた文字列。 |
item.queue |
このアイテムが属するキュー。このフィールドが指定されていない場合は、 |
item.repositoryError |
コネクタまたはリポジトリのエラーの詳細を保存するには、このフィールドに入力します。この情報は管理コンソールに表示されます。このフィールドは、 |
connectorName |
この呼び出しを行うコネクタの名前。 形式: datasources/{sourceId}/connectors/{ID} |
debugOptions |
一般的なデバッグ オプション。 |
レスポンスの本文
成功した場合、レスポンスの本文には Item
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
詳細については、承認ガイドをご覧ください。
PushItem
インデックス登録キューにプッシュされるアイテムを表します。
JSON 表現 |
---|
{ "name": string, "type": enum ( |
フィールド | |
---|---|
name |
インデックス登録キューに push する 形式: datasources/{sourceId}/items/{ID} これは必須項目です。最大文字数は 1,536 文字です。 |
type |
push 動作を定義する push オペレーションのタイプ。 |
metadataHash |
リポジトリに従うアイテムのメタデータ ハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと |
structuredDataHash |
リポジトリに従ったアイテムの構造化データのハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと |
contentHash |
リポジトリに従ったアイテムのコンテンツ ハッシュ。指定すると、このアイテムのステータスの変更方法が決まります。このフィールドと |
payload |
代替リポジトリ ID などのメタデータなど、コネクタのドキュメントの状態に関する追加情報を提供します。最大長は 8,192 バイトです。 Base64 でエンコードされた文字列。 |
queue |
このアイテムが属するキュー。このフィールドが指定されていない場合は、 |
repositoryError |
コネクタまたはリポジトリのエラーの詳細を保存するには、このフィールドに入力します。この情報は管理コンソールに表示されます。このフィールドは、 |
PushItem.Type
push 動作を定義する push オペレーションのタイプ。
列挙型 | |
---|---|
UNSPECIFIED |
デフォルトは UNSPECIFIED です。push オペレーションで ItemStatus を変更しないことを指定します。 |
MODIFIED |
前回の update 呼び出し以降に、リポジトリ ドキュメントが変更または更新されたことを示します。既存のアイテムのステータスを MODIFIED に変更します。このフィールドが既存のアイテム以外に対して呼び出されると、ステータスは NEW_ITEM に変更されます。 |
NOT_MODIFIED |
前回の update 呼び出し以降、リポジトリ内のアイテムが変更されていません。この push オペレーションは、ステータスを ACCEPTED 状態に設定します。 |
REPOSITORY_ERROR |
このアイテムに関するリポジトリ エラーがコネクタで発生しています。ステータスを REPOSITORY_ERROR に変更します。アイテムは予約解除され、指数バックオフによって決定される将来の時刻に再スケジュールされます。 |
REQUEUE |
予約済みのアイテムに対してのみ、REQUEUE を使用してプッシュ呼び出しを行います。この操作を行うと、アイテムの予約が解除され、利用可能な時間が実時間にリセットされます。 |