Method: projects.databases.importDocuments

Nhập tài liệu vào Google Cloud Firestore. Các tài liệu hiện có có cùng tên sẽ bị ghi đè. Quá trình nhập diễn ra ở chế độ nền và bạn có thể giám sát cũng như quản lý tiến trình nhập thông qua tài nguyên Vận hành được tạo. Nếu thao tác Database.importDocuments bị huỷ, thì có thể một nhóm nhỏ dữ liệu đã được nhập vào Cloud Firestore.

yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
name

string

Bắt buộc. Cơ sở dữ liệu để nhập vào. Phải có dạng: projects/{projectId}/databases/{databaseId}.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string,
  "namespaceIds": [
    string
  ]
}
Trường
collectionIds[]

string

Mã bộ sưu tập cần nhập. Chưa xác định có nghĩa là tất cả các tập hợp được đưa vào quá trình nhập.
inputUriPrefix

string

Vị trí của các tệp đã xuất. Giá trị này phải khớp với outputUriPrefix của một ExportDocumentsResponse từ một tệp xuất đã hoàn tất thành công. Hãy xem: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix.
namespaceIds[]

string

Danh sách trống đại diện cho tất cả không gian tên. Đây là cách sử dụng ưu tiên cho các cơ sở dữ liệu không sử dụng không gian tên.

Một phần tử chuỗi trống đại diện cho không gian tên mặc định. Bạn nên sử dụng thuộc tính này nếu cơ sở dữ liệu có dữ liệu trong không gian tên không phải vùng chứa mặc định nhưng không muốn đưa dữ liệu vào vùng chứa tên đó. Mỗi không gian tên trong danh sách này phải là duy nhất.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của Operation.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về việc xác thực.