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à có thể theo dõi cũng như quản lý tiến trình này thông qua tài nguyên Hoạt động được tạo. Nếu thao tác database.importDocuments bị huỷ, thì có thể là một tập hợp con 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

Tham 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 chỉ định có nghĩa là tất cả tập hợp có trong dữ liệu 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 ExportDocumentsResponse từ một lượt 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ả các không gian tên. Đây là cách sử dụng ưu tiên cho những 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 dùng cách này nếu không muốn đưa dữ liệu vào không gian tên mặc định của cơ sở dữ liệu. 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 phiên bản của Operation.

Phạm vi uỷ quyền

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

  • 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ề hoạt động xác thực.