색인 생성 대기열에서 예약되지 않은 항목을 폴링하고 가장 높은 우선순위 ItemStatus에서 가장 오래된 타임스탬프가 있는 항목부터 시작하여 세트를 예약됨으로 표시합니다. 우선순위 순서는 다음과 같습니다.
항목을 예약하면 다른 스레드에서 폴링하여 중복 세트를 만들 수 없습니다.
예약된 항목을 처리한 후 클라이언트는 index,를 호출하거나 REQUEUE. 유형으로 push를 호출하여 항목을 예약되지 않은 상태로 되돌려야 합니다.
업데이트 또는 푸시 메서드가 호출되지 않더라도 4시간 후에 항목이 자동으로 사용 가능해집니다 (예약 해제됨).
이 API를 실행하려면 관리자 또는 서비스 계정이 필요합니다. 사용되는 서비스 계정은 해당 데이터 소스에 허용 목록에 추가된 계정입니다.
HTTP 요청
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/items:poll
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
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.indexinghttps://www.googleapis.com/auth/cloud_search
자세한 내용은 승인 가이드를 참고하세요.