Method: projects.databases.importDocuments

นำเข้าเอกสารไปยัง Google Cloud Firestore ระบบจะเขียนทับเอกสารที่มีอยู่แล้วซึ่งมีชื่อเดียวกัน การนำเข้าจะเกิดขึ้นในเบื้องหลัง รวมทั้งสามารถตรวจสอบและจัดการความคืบหน้าได้ผ่านทรัพยากรการดำเนินการที่สร้างขึ้น หากยกเลิกการดำเนินการ Database.importDocuments อาจเป็นไปได้ว่ามีการนำเข้าข้อมูลย่อยไปยัง Cloud Firestore แล้ว

คำขอ HTTP

POST https://firestore.googleapis.com/v1/{name=projects/*/databases/*}:importDocuments

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

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

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

string

ต้องระบุ ฐานข้อมูลที่จะนำเข้า ควรอยู่ในรูปแบบ projects/{projectId}/databases/{databaseId}

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

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

การแสดง JSON 
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string,
  "namespaceIds": [
    string
  ]
}
ช่อง
collectionIds[]

string

รหัสคอลเล็กชันที่จะนำเข้า ไม่ระบุ หมายถึงคอลเล็กชันทั้งหมดที่รวมอยู่ในการนำเข้า
inputUriPrefix

string

ตำแหน่งของไฟล์ที่ส่งออก ซึ่งต้องตรงกับเอาต์พุตUriPrefix ของ ExportDocumentsResponse จากการส่งออกที่เสร็จสมบูรณ์ โปรดดูgoogle.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix
namespaceIds[]

string

รายการที่ว่างเปล่าจะแสดงเนมสเปซทั้งหมด วิธีนี้เหมาะสำหรับใช้ฐานข้อมูลที่ไม่ใช้เนมสเปซ

องค์ประกอบสตริงว่างจะแสดงเนมสเปซเริ่มต้น ควรใช้แอตทริบิวต์นี้หากฐานข้อมูลมีข้อมูลในเนมสเปซที่ไม่ใช่ค่าเริ่มต้น แต่ไม่ต้องการรวมข้อมูลดังกล่าว เนมสเปซแต่ละรายการในรายการนี้ต้องไม่ซ้ำกัน

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Operation

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการตรวจสอบสิทธิ์