インデックス キューから予約されていないアイテムをポーリングし、優先度が最も高い ItemStatus
から最も古いタイムスタンプを持つアイテムから順に、セットを予約済みとしてマークします。優先順位は次のとおりです。
アイテムを予約すると、他のスレッドからのポーリングで重複するセットが作成されなくなります。
予約済みアイテムを処理した後、クライアントは index,
を呼び出すか、タイプ REQUEUE.
で push
を呼び出して、アイテムを予約解除状態に戻す必要があります。
更新メソッドや push メソッドが呼び出されなくても、アイテムは 4 時間後に自動的に利用可能(予約解除)になります。
この API を実行するには、管理者またはサービス アカウントが必要です。使用されるサービス アカウントは、対応するデータソースでホワイトリストに登録されているアカウントです。
HTTP リクエスト
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/items:poll
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
name |
アイテムをポーリングするデータソースの名前。形式: datasources/{sourceId} |
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "connectorName": string, "statusCodes": [ enum ( |
フィールド | |
---|---|
connectorName |
この呼び出しを行うコネクタの名前。 形式: datasources/{sourceId}/connectors/{ID} |
statusCodes[] |
ポーリングするアイテムを、これらのステータスを持つアイテムに制限します。 |
limit |
返されるアイテムの最大数。 最大値は 100、デフォルト値は 20 です。 |
queue |
アイテムを取得するキュー名。指定しない場合、items.poll は「default」キューから取得します。最大で 100 文字です。 |
debugOptions |
一般的なデバッグ オプション。 |
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"items": [
{
object ( |
フィールド | |
---|---|
items[] |
コネクタが処理できるキュー内のアイテムのセット。 これらのアイテムには、次のフィールドのサブセットが入力されます。 |
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
詳しくは、認可ガイドをご覧ください。