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

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

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

string

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

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

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

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

string

ชื่อของตัวเชื่อมต่อที่เรียกใช้การเรียกนี้

รูปแบบ: แหล่งข้อมูล/{sourceId}/เครื่องมือเชื่อมต่อ/{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

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