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/v1beta2/{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

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
}
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.v1beta2.ExportDocumentsResponse.output_uri_prefix.

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.