Method: indexing.datasources.items.poll

نظرسنجی برای موارد رزرو نشده از صف نمایه سازی و علامت گذاری مجموعه ای به عنوان رزرو شده، با مواردی شروع می شود که دارای قدیمی ترین مُهر زمانی از ItemStatus با بالاترین اولویت هستند. ترتیب اولویت به شرح زیر است:

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

رزرو موارد تضمین می کند که نظرسنجی از رشته های دیگر نمی تواند مجموعه های همپوشانی ایجاد کند.

پس از رسیدگی به موارد رزرو شده، مشتری باید موارد را به حالت رزرو نشده برگرداند، یا با فراخوانی index, یا با فراخوانی push با نوع REQUEUE.

موارد به‌طور خودکار پس از 4 ساعت در دسترس می‌شوند (بدون رزرو) حتی اگر به‌روزرسانی یا روش فشاری فراخوانی نشود.

این API برای اجرا به یک ادمین یا حساب سرویس نیاز دارد. حساب سرویس مورد استفاده در فهرست سفید منبع داده مربوطه است.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
name

string

نام منبع داده برای موارد نظرسنجی. قالب: منابع داده/{sourceId}

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "connectorName": string,
  "statusCodes": [
    enum (ItemStatus.Code)
  ],
  "limit": integer,
  "queue": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
زمینه های
connectorName

string

نام رابطی که این تماس را برقرار می کند.

قالب: منابع داده/{sourceId}/connectors/{ID}

statusCodes[]

enum ( ItemStatus.Code )

موارد نظرسنجی شده را به موارد دارای این وضعیت محدود کنید.

limit

integer

حداکثر تعداد اقلام برای بازگشت.

حداکثر مقدار 100 و مقدار پیش فرض 20 است.

queue

string

نام صف برای واکشی موارد از. اگر نامشخص باشد، items.poll از صف «پیش‌فرض» واکشی می‌شود. حداکثر طول 100 کاراکتر است.

debugOptions

object ( DebugOptions )

گزینه های رایج اشکال زدایی

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "items": [
    {
      object (Item)
    }
  ]
}
زمینه های
items[]

object ( Item )

مجموعه ای از موارد از صف موجود برای پردازش اتصال دهنده.

این موارد دارای زیر مجموعه فیلدهای زیر هستند:

version

metadata.hash

structuredData.hash

content.hash

payload

status

queue

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.