Method: indexing.datasources.items.poll

Khảo sát 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 tập hợp 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. 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 hoạt động thăm dò ý kiến từ các luồng khác không thể tạo ra các tập hợp trùng lặp.

Sau khi xử lý các mục được đặt trước, ứng dụng phải đặt các mục đó trở lại trạng thái chưa đặt trước bằng cách gọi index, hoặc gọi push với loại REQUEUE.

Các mục sẽ tự động có sẵn (không được đặ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.

API này yêu cầu tài khoản quản trị 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 đưa vào danh sách trắng 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

Thông số
name

string

Tên của Nguồn dữ liệu để thăm dò ý kiến về 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 lệnh gọi này.

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

enum (ItemStatus.Code)

Giới hạn các mục được thăm dò ý kiến ở những trạng thái này.
limit

integer

Số lượng 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 không 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)
    }
  ]
}
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ó một tập hợp con các trường sau đây:

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.