Method: indexing.datasources.items.poll

Thăm dò các mục chưa được đặt trước từ hàng đợi lập chỉ mục và đánh dấu một nhóm là đặt trước, bắt đầu bằng các mục có dấu thời gian cũ nhất từ ItemStatus có mức độ ưu tiên cao nhất. Sau đây là thứ tự ưu tiên:

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

Việc đặt trước các mục đảm bảo rằng việc thăm dò ý kiến từ các luồng khác không thể tạo ra các tập hợp chồng chéo.

Sau khi xử lý các mục dành riêng, ứng dụng sẽ đưa các mục trở về trạng thái chưa đặt trước bằng cách gọi index, hoặc gọi push thuộc loại REQUEUE.

Các mặt hàng sẽ tự động xuất hiện (chưa đặt trước) sau 4 giờ ngay cả khi bạn không gọi phương thức cập nhật hoặc đẩy nào.

API này yêu cầu quản trị viên hoặc tài khoản dịch vụ để thực thi. Tài khoản dịch vụ được sử dụng là tài khoản có trong danh sách cho phép trong nguồn dữ liệu tương ứng.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
name

string

Tên của Nguồn dữ liệu để thăm dò các mục. Định dạng: datasources/{sourceId}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "connectorName": string,
  "statusCodes": [
    enum (ItemStatus.Code)
  ],
  "limit": integer,
  "queue": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
Các trường
connectorName

string

Tên của trình kết nối thực hiện cuộc gọi này.

Định dạng: datasources/{sourceId}/Connectors/{ID}
statusCodes[]

enum (ItemStatus.Code)

Chỉ chọn những mặt hàng có trạng thái này để được thăm dò ý kiến.
limit

integer

Số lượng mục tối đa cần trả lại.

Giá trị tối đa là 100 và giá trị mặc định là 20.
queue

string

Tên hàng đợi để tìm nạp mục. Nếu chưa chỉ định, items.poll sẽ tìm nạp từ hàng đợi "mặc định". Độ dài tối đa là 100 ký tự.
debugOptions

object (DebugOptions)

Các tuỳ chọn gỡ lỗi phổ biến.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "items": [
    {
      object (Item)
    }
  ]
}
Các trường
items[]

object (Item)

Tập hợp các mục từ hàng đợi có sẵn để trình kết nối xử lý.

Các mục này có tập hợp con các trường sau đây được điền sẵn:

version

metadata.hash

structuredData.hash

content.hash

payload

status

queue

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.