Method: indexing.datasources.items.poll

ค้นหารายการที่ยังไม่ได้จองจากคิวการจัดทําดัชนี และทําเครื่องหมายชุดเป็น "จองแล้ว" โดยเริ่มจากรายการที่มีการประทับเวลาเก่าที่สุดจากItemStatusที่มีลําดับความสําคัญสูงสุด ลำดับความสำคัญมีดังนี้

ERROR

MODIFIED

NEW_ITEM

ACCEPTED

การจองรายการช่วยให้มั่นใจได้ว่าการสำรวจจากชุดข้อความอื่นๆ จะไม่สร้างชุดข้อมูลที่ทับซ้อนกัน

หลังจากจัดการรายการที่จองแล้ว ลูกค้าควรทำให้รายการกลับเข้าสู่สถานะ "ไม่ได้จอง" อีกครั้งโดยเรียกใช้ index, หรือเรียกใช้ push ที่มีประเภท REQUEUE.

สินค้าจะพร้อมจำหน่าย (ยกเลิกการจอง) โดยอัตโนมัติหลังจากผ่านไป 4 ชั่วโมง แม้ว่าจะไม่มีการเรียกใช้เมธอดการอัปเดตหรือ Push ก็ตาม

API นี้ต้องใช้บัญชีผู้ดูแลระบบหรือบัญชีบริการในการดําเนินการ บัญชีบริการที่ใช้คือบัญชีที่อยู่ในรายการที่อนุญาตในแหล่งข้อมูลที่เกี่ยวข้อง

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ชื่อแหล่งข้อมูลสําหรับสำรวจรายการ รูปแบบ: datasources/{sourceId}

เนื้อหาของคำขอ

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "connectorName": string,
  "statusCodes": [
    enum (ItemStatus.Code)
  ],
  "limit": integer,
  "queue": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
ช่อง
connectorName

string

ชื่อของเครื่องมือเชื่อมต่อที่เรียกใช้การดําเนินการนี้

รูปแบบ: datasources/{sourceId}/connectors/{ID}
statusCodes[]

enum (ItemStatus.Code)

จำกัดรายการที่สำรวจไว้เฉพาะรายการที่มีสถานะเหล่านี้
limit

integer

จำนวนรายการสูงสุดที่จะแสดง

ค่าสูงสุดคือ 100 และค่าเริ่มต้นคือ 20
queue

string

ชื่อคิวที่จะดึงข้อมูลรายการ หากไม่ได้ระบุ items.poll จะดึงข้อมูลจากคิว "default" โดยมีความยาวสูงสุดได้ 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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์