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:
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 |
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 ( |
Các trường | |
---|---|
connectorName |
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[] |
Chỉ chọn những mặt hàng có trạng thái này để được thăm dò ý kiến. |
limit |
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 |
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 |
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 ( |
Các trường | |
---|---|
items[] |
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: |
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.