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/v1beta1/{name=projects/*/databases/*}:importDocuments
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
name |
Cơ sở dữ liệu để nhập vào. Phải có dạng: |
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 } |
Trường | |
---|---|
collectionIds[] |
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 |
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: |
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.