- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- IndexItemOptions
- ลองใช้งาน
อัปเดต ACL, ข้อมูลเมตา และเนื้อหา Item
รายการ ระบบจะแทรก Item
หากยังไม่มี วิธีนี้ไม่รองรับการอัปเดตบางส่วน ระบบจะล้างช่องที่ไม่มีค่าที่ระบุไว้ออกจากดัชนีของ Cloud Search
API นี้ต้องใช้บัญชีผู้ดูแลระบบหรือบัญชีบริการเพื่อดำเนินการ บัญชีบริการที่ใช้เป็นบัญชีที่อนุญาตพิเศษในแหล่งข้อมูลที่เกี่ยวข้อง
คำขอ HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
item.name |
ชื่อของสินค้า รูปแบบ: แหล่งข้อมูล/{sourceId}/items/{itemId} นี่เป็นฟิลด์ที่ต้องระบุ ซึ่งมีความยาวสูงสุด 1,536 อักขระ |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "item": { "name": string, "acl": { "inheritAclFrom": string, "aclInheritanceType": enum ( |
ช่อง | |
---|---|
item.acl |
รายการควบคุมการเข้าถึงสำหรับรายการนี้ |
item.metadata |
ข้อมูลเมตา |
item.structuredData |
ข้อมูลที่มีโครงสร้างสำหรับรายการที่ควรสอดคล้องกับคำจำกัดความของออบเจ็กต์ที่ลงทะเบียนในสคีมาสำหรับแหล่งข้อมูล |
item.content |
เนื้อหาของรายการที่จะทำดัชนีและกำหนดให้ค้นหาข้อความได้ |
item.version |
ต้องระบุ ระบบจัดทำดัชนีจะจัดเก็บเวอร์ชันจากแหล่งข้อมูลเป็นสตริงไบต์ และเปรียบเทียบเวอร์ชันรายการในดัชนีกับเวอร์ชันของรายการที่อยู่ในคิวโดยใช้การจัดลำดับแบบพจนานุกรม การจัดทำดัชนีของ Cloud Search จะไม่จัดทำดัชนีหรือลบรายการที่อยู่ในคิวซึ่งมีค่าเวอร์ชันน้อยกว่าหรือเท่ากับเวอร์ชันของรายการที่จัดทำดัชนีในปัจจุบัน ความยาวสูงสุดของช่องนี้คือ 1024 ไบต์ ดูข้อมูลเกี่ยวกับผลกระทบที่เวอร์ชันของรายการมีต่อกระบวนการลบได้ที่จัดการการแก้ไขหลังจากลบด้วยตนเอง สตริงที่เข้ารหัสฐาน 64 |
item.status |
สถานะของสินค้า ฟิลด์เอาต์พุตเท่านั้น |
item.queue |
จัดคิวที่เป็นของรายการนี้ มีความยาวได้สูงสุดไม่เกิน 100 อักขระ |
item.payload |
เครื่องมือเชื่อมต่อสถานะเพิ่มเติมจัดเก็บรายการนี้ได้ ความยาวสูงสุดคือ 10,000 ไบต์ สตริงที่เข้ารหัสฐาน 64 |
item.itemType |
ประเภทของรายการนี้ |
connectorName |
ชื่อของเครื่องมือเชื่อมต่อที่เรียกใช้นี้ รูปแบบ: แหล่งข้อมูล/{sourceId}/เครื่องมือเชื่อมต่อ/{ID} |
mode |
ต้องระบุ RequestMode สำหรับคำขอนี้ |
debugOptions |
ตัวเลือกการแก้ไขข้อบกพร่องทั่วไป |
indexItemOptions |
|
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Operation
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์
IndexItemOptions
การแสดง JSON |
---|
{ "allowUnknownGsuitePrincipals": boolean } |
ช่อง | |
---|---|
allowUnknownGsuitePrincipals |
ระบุว่าคำขอดัชนีควรอนุญาตผู้ใช้หลักของ Google Workspace ที่ไม่มีอยู่หรือถูกลบไปแล้วหรือไม่ |