Method: projects.databases.importDocuments

นำเข้าเอกสารไปยัง Google Cloud Firestore ระบบจะเขียนทับเอกสารที่มีอยู่แล้วซึ่งมีชื่อเดียวกัน การนำเข้าจะเกิดขึ้นในเบื้องหลังและคุณสามารถตรวจสอบและจัดการความคืบหน้าของการนำเข้าได้ผ่านทรัพยากรการดำเนินการที่สร้างขึ้น หากการดำเนินการ Databases.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

ตำแหน่งของไฟล์ที่ส่งออก โดยต้องตรงกับ ExportUriPrefix ของ 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

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