Method: indexing.datasources.items.poll

Các cuộc thăm dò ý kiến cho các mục chưa được đặt trước trong 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ừ mức ItemStatus có mức độ ưu tiên cao nhất. Thứ tự ưu tiên như sau:

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

Việc đặt trước các mục đảm bảo rằng việc thăm dò 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 đặt trước, ứng dụng nên đặt các mục 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ục sẽ tự động xuất hiện (không đặt trước) sau 4 giờ ngay cả khi không có phương thức cập nhật hoặc đẩy nào được gọi.

Để thực thi API này, bạn cần có tài khoản quản trị viên hoặc tài khoản dịch vụ. Tài khoản dịch vụ được sử dụng là tài khoản được đưa vào 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

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)
  }
}
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ỉ bao gồm các mặt hàng có các trạng thái này trong cuộc thăm dò ý kiến.
limit

integer

Số mục tối đa cần trả về.

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 các mục. Nếu bạn chưa chỉ định, items.poll sẽ tìm nạp từ "default" hàng đợi. Độ 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)
    }
  ]
}
Trường
items[]

object (Item)

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

Các mục này có một số trường nhỏ được điền sẵn sau đây:

version

metadata.hash

structuredData.hash

content.hash

payload

status

queue

Phạm vi cấp phép

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.